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PREFACE 


The HUNTER microcomputer is a self contained and 
truly portable system. Its built-in operating system 
contains an accurate emulation of the worid-standard 
CP/M operating system and virtual floppy disk drive, 
implemented in RAM memory. Other built-in features 
include a powerful BASIC interpreter, a terminal 
emulation package, a flexible text editor with full¬ 
screen facilities based on the popular Wordstar and a 
comprehensive range of communications protocols. 
User memory is shared between work areas, program and 
data files. 


CP/M is a registered trademark of Digital Research Inc. 
Wordstar is a trademark of MicroPro International Corp. 



REPORTED 'BUGS' 

Some of the reported 'bugs' which existed in the system have been 

corrected. 

These are as follows: 

a) The format of the KILL statement in Basic has been extended to 
include the form Kill A$,B$.... The use of 'name strings' in the 
NAME statement has also been included. 

b) The calls via Basic are also functioning correctly. This 
enables the call for the status of the serial port to be used 
again in place of the manual peeking of the communications 
pointers. 

c) The reported problems with IF THEN ELSE have been corrected. 

d) Machine code calls from Basic are also functioning. 

e) Line feeds are no longer echoed to the screen during LLOAD, 
LPRINT etc. 

f) The REM and ' have been separated out into separate tokens. 

g) Communications timeouts have been introduced. 

h) It is now possible to SAVE and LOAD both ASCII and Basic 
tokenised files from the Basic interpreter. 

i) In some versions of operating system, complex string expressions 
did lead to error. This has been corrected in the new version. 

j) In previous versions, the wand returned ',' in place of '-' in 
CODE39. 

There are still, however, some idiosyncrasies which as yet are not 

corrected in this release of the operating system, but these will be 

corrected when further releases are produced. 

a) WHILE-WEND requires that the WHILE is at the start of a line in 
Basic. 

b) There are some problems with the VAL statement in basic, e.g. 
VALC.005") gives 0 not 0.005. 
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COMMUNICATION PARAMETERS 

There has been an addition to the communications parameters in order 
to provide a timeout option on both receive and transmit 
communications. These values can be set from 10 seconds to 1 minute 
in intervals of 10 secs. Unlike the protocol timeouts, they can be 
disabled by selecting 'no' in the menu. 

The receive timeout is activated when the HUNTER requests an input 
from the port. If an input is not received within the specified 
time, then a communications error '8' is given. The user may elect 
to try again by pressing 'X' where upon the HUNTER will wait for an 
input again for the selected time and timeout again if nothing is 
received. 

The transmit timeout is activated when the HUNTER tries to transmit 
but is prevented from doing so by the various handshake lines. If 
after the specified time the HUNTER is still not able to transmit, 
then a communications error '9' will occur. By pressing ’X* the 
HUNTER can be made to re-attempt the transmission. 

Both transmit and receive timeouts can be trapped by use of the BASIC 
'on comms goto' statement and the error number returned in location 
COMERR. 
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WELCOME TO HUNTER 


1.1 Fig 1.1 THE HUWTER 



Husky HUNTER is probably the smallest and toughest CP/M 
microcomputer ever made. 

It is resistant to moisture, dust, vibration, shock and electro¬ 
magnetic interference. But please don't abuse it. Inside the 
impervious. ; cast aluminium case is some of the most advanced 
technology money can buy. Don't drop HUNTER needlessly, use it 
to strike other objects or pile heavy things on top of it. 

If you can't find the information you need in this manual or you 
have any problems with HUNTER, please call us. We've done all 
we can to make HUNTER a practical and utilitarian tool, not a 
frustrating incumbrance. We hope you agree. After all, HUNTER 
is our baby. 


The HUNTER team 

HUSKY COMPUTERS LTD 
P 0 BOX 135 
3^5 FQLESHILL ROAD 
COVENTRY" CV6 5RW 
ENGLAND 

TEL:(0203)’668181 
TELEX: 317«50 HUSKY G 
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1.1.2 HUNTER 

Measuring 21.6 X 15.6 X 3.2 cm (8.5" x 6.2" x 1.3") and weighing 
less than 1200g (31b), HUNTER is a completely self contained 
computer system. HUNTER is sealed against moisture, dust and 
other hazards. 

NEVER attempt to open the case - there are no user serviceable 
parts inside. 

The CP/M emulating operating system, now containing a flexible 
text editor, has RAM-disc emulation and provides a totally 
compatible environment for a vast range of commercially 
available software. 

HUNTER'S Basic interpreter has been specially developed to be 
compatible with other popular Basics and to meet the extra 
demands of a portable system. Special statements, for example 
to filter input data so that only formats consistent with the 
program are accepted, simplify user programming. 

Communications with instruments or computers, including main¬ 
frames, are user programmable. Protocols can be chosen from a 
wide selection, including a choice of synchronous or 
asynchronous types. 

CP/M compatibility is an important feature. A large range of 
commercially available software, including packages such as 
spreadsheets, can now be run on HUNTER with no modifications. 

Disk emulation in RAM memory allows standard programs such as 
WordStar and SuperCalc to run without modification, while files 
can be exchanged easily. 


WordStar is a registered trademark of MicroPro. International 
Corporation. 

SuperCalc is a registered trademark of Sorcim. 

CP/M is a registered trademark of Digital Research Corp 
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USING THE MANUAL 


1.2.1 This manual is intended to fulfil several functions. 

1) As an introduction to the operation, programming and 
use of HUNTER. 

2) As a source of reference for technical data about HUNTER. 

3) As the vehicle for achieving HUNTER'S full potential in 
diverse user applications. 

It is not intended as a guide for the first time computer or 
Basic user. For guidance on these subjects, the reader is 
referred to the many excellent introductory works dealing with 
microcomputer Basic, now commonly available. 

1.2.2 HOW TO USE THIS MANUAL 

The manual is split into a number of parts. Part 1 is this 
introduction. The others are: 

2) HUNTER Operation; 

Description of HUNTER - its File Manager, communications, 
virtual screen and setting of the internal cloek/calandar. 

3) File Manager: 

Description of HUNTER'S File Manager DEMOS (Disk Emulation 
Operating System) and CP/M compatibility. 

4) Basic Programming: 

Description of HUNTER Basic Programming techniques, use of the 
Basic Editor plus listing of error and warning messages. 

5) Basic Functions: 

Detailed explanation of the resident HUNTER Basic interpreter 
commands. 

6) Communications: 

Full description of HUNTER'S flexible serial data communications 
facilities. 

7) HUNTER Text Editor: 

Instruction in the use of the text editing facility within 
HUNTER. 
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8) Maintenance and Accessories: 

Instructions for case sealing, pressure relief etc., and 
information of accessories available for Hunter. 

9) Appendix: 

Specification, code conversion tables, etc. 

10) Index: 

Alphabetic index to pages. 

The contents of each section are listed on the first page following 
the divider. 
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PAGE FORMATS 


1.3 Each page in this manual is laid out on a standard format. 

Sections are identified in the left margin by section numbers 
e.g. 1.3, nieaning Part 1, section 3. 


The top of each page contains the part name to the left and the 
first section number of the page to the right. At the foot 
appears HUNTER'S operating system revision number (to which this 
manual refers) to the left and the page number to the right. 


The page number is in two parts. The first number refers to the 
part of the manual being studied, the second to the page number 
referenced from the start of each part. 
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Fig 2.1 HUNTER LAYOUT 
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SECTION 2.1 


SWITCHING ON 


2.1.1 To switch HUNTER on press the key marked PWR at the top right 
hand corner of the keyboard. HUNTER should respond with a 
'beep'. If not, check that the batteries have been installed or 
need to be replaced. See section 2.8, BATTERIES. If all is 
well the following 'Welcome Message' should be displayed 

Fig 2.2 ’WELCOME MESSAGE' 



If all is not well and the above display does not appear, it 
could be for one of the following reasons. 

2.1.1.1 Display needs adjustment: The Liquid Crystal Display (LCD) used 
in HUNTER can vary its angle of display to suit various opera¬ 
ting positions. This is obtained by pressing CTL/FN 
(control/function) and either the cursor up or cursor down keys 
until the desired display angle is found. 

2.1.1.2 Auto start program loaded: A program has been entered into 
HUNTER to automatically run when ever it is switched on. If this 
is the case the operator should be prompted by HUNTER or have 
been informed what to do next. 

If neither of the above produce a response, check the PANIC 
section 2.9 for further information. 

2.1.2 SELECTING THE FILE MANAGER 

Having obtained the above 'Welcome Message' HUNTER'S File 
Manager is entered by pressing any key. The screen will then 
display HUNTER'S various system programs, any of which may be 
selected by operation of the appropriate function key. 
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FILE MANAGER DISPLAY 


2.2 HUNTER'S File Manager, called DEMOS 2.2 (Disk EMulation 

Operating System version 2.2) is obtained by procedures 
described above. 

2.2.1 FILE MANAGER SCREEN 

Following power up the File Manager screen looks like this: 
(Some versions may vary. This is a typical example) 


29 NOV 1983 09:50 
** DEMOS VER 2.2 9.A** 

BAS .sys CCMS .sys CLCK .sys 

TERM .sys EDIT .sys 


DIR STAT BAS COMS CLCK TERM EDIT KEYS 


NOTE: Only system files .(.SYS extension) are displayed. Further 
files can be displayed with the 'DIR' command. The time display 
does not update to conserve power. 

The function keys are programmed as follows: 

1. DIR; (File directory) 

2. STAT (File status) 

3. BAS (Basic interpreter) 

4. COMS (Initialise corrmunications) 

5. CLCK (Initialise clock) _ 

6. TERM (Terminal emulation) 

7. EDIT (Text Editor) 

8. KEYS (Alternate function keys) 

The function 'KEYS' displays an alternative menu. See below. 

DIR STAT INP SAVE TYPE REN SEND KEYS 

J i.*V' ‘ 

Functions can be selected by either the appropriate function key 
or typing the longhand version. 
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HUNTER SYSTEM FILES 


2.3 HUNTER'S system files are not true files in the CP/M sense. They 

are built-in utility programs designed to support use of the 
computer. The function of each is described below. 


2.3.1 FILE DIRECTORY 

Displays a list of filenames. The use of wildcards is 
supported. See section 3.4.3, WILDCARDS. 


2.3.2 FILE STATUS 

This function displays the file status, read/write or read only, 
file size and remaining file space. See section 3.4.3.16, STAT. 


2 . 3.3 basic interpreter 

Access to HUNTER'S Basic interpreter is provided with this 
option. See Part 4, BASIC PROGRAMMING. 


2.3.4 INITIALISE COMMUNICATIONS 

The parameters of HUNTER'S industry standard RS-232/V24 
interface may be changed for compatibility with additional 
external equipment. See Part 6, COMMUNICATIONS. 


2.3.5 INITIALISE CLOCK 

The date and time of HUNTER'S internal calendar clock may be set 
with this function. Calendar maintenance is completely 
automatic once the correct date and time have been entered. See 
section 3.4.3.2, CLCK. 


2.3.6 TERMINAL EMULATION 

HUNTER emulates a simple CRT terminal. The communications baud 
rate and protocols are first initialised with 'INITIALISE 
COMMUNICATIONS' function. See section 6.8, TERMINAL EMULATION. 


2.3.7 • EDIT 

This activates the text editor. See section 7. 
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2.3.8 KEYS 

Operation of the function 'KEYS' displays the alternate function 
key display line, as follows: 

DIR STAT INP SAVE TYPE REN SEND KEYS 

Further operation of the function 'KEYS' will return HUNTER to 
the original function key display line. 
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SECTION 2.4 


KEYBOARD 


2.4 HUNTER'S keyboard comprises 58 keys. Most are laid out in the 

standard QWERTY positions, but there are a few non-standard keys 
such as PWR, ESC and the cursor keys. 

When held down, the keys will auto-repeat at about 8 characters 
per second. 

2.4.1 POWER AND HELP 

Used for switching HUNTER on and off, 

NOTE: This key is generally used to ask for power, in which case 
it operates just for power on/off. If it has been programmed 
for HELP, it is necessary to press 'Shift Power' to turn HUNTER 
off. 

2.4.2 ENTER 

The ENTER key is used for terminating input from the keyboard. 
For certain inputs, replying to menus etc., the ENTER key is not 
used as HUNTER will respond automatically to keyboard input. 

NOTE: 'ENTER' is often called 'RETURN' in user programs. The 
functions are identical. 

2.4.3 SHIFT 

This key accesses the legends on the upper half of the keys and 
must be used in combination with another key. The keys A-Z 
produce upper case with the shift key. 


2.4.4 CURSOR KEYS 

The cursor control keys perform a number of functions including 
adjustment of viewing angle, moving the virtual screen window as 
well as moving the cursor. 


2.4.5 DELETE, BACKSPACE AND RACKARROW 

Delete, backspace and backarrow keys within DEMOS and Basic all 
perform the same function, i.e. deletes the character to the 
left of the cursor. Some user programs in CP/M may use 
backspace differently by not deleting the character, but only 
moving the cursor back. 
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2.4.6 CONTROL 

This key is similar to ’shift’ in that it generates a new set of 
ASCII codes. 

By holding down 'CTL' and pressing an alphabetic key, a control 
code is generated e.g. 'CTL A' clears the screen and 'CTL G' 
sounds the bleeper. (Note: this function is inhibited in the 
file manager). 

Another use of control is for adjustment of the LCD display 
viewing angle. By pressing 'CTL' and either up or down arrow 
the viewing angle may be changed to suit the user. This function 
is always active. 

2.4.7 FUNCTION KEYS 

The CTL/FN key may also be used to generate key sequences known 
as function keys. These strings may be used for frequently used 
commands and are present within system programs (DEMOS, Basic, 
etc.) They are operated in a similar fashion to control, but 
pressing a numeric key 1-8, giving the eight function keys. 

The commands implemented are displayed on the bottom line of 
display (this may be turned off, see the LBL key). 

Within Basic programs the key may be initialised to new 
functions, see section 4.5.4 FUNCTION KEYS. 

2.4.8 ESCAPE AND BREAK 

'ESC' is an upper-shifted key used to break into and terminate 
execution of HUNTER Basic. 

'BREAK' (BRK) is used to interrupt a Basic program. See 'ON 
BREAK' in Part 5, BASIC FUNCTIONS. Break is also available for 
CP/M programs and in terminal mode. 


2.4.9 INS AND LBL 

'INS' will return the virtual screen window to its original 
position. 

'control INS' will reverse the operation of the ’SHIFT 1 key on 
the characters A - Z, providing a 'CAPS' function. 

'LBL' switches the function line display on and off. LBL is an 
upper shifted key. 

VER.V09F 


PAGE 2-8 



HUNTER OPERATION 


SECTION 2.4 


2.4.10 HUNTER'S keyboard is built for extended use and long life. The 
keyboard will withstand assaults from water, coffee and 
mechanical shock, but it can be damaged by impact with sharp 
objects. 

2.4.11 KEYBOARD RE-DEFINITION 

Keyboard keys are each equated to the characters they represent 
by unique numerical codes, as listed in section 9.2, ASCII 
CHARACTER SET. These values are defined according to the 
American Standard Code for Information Interchange (ASCII). 

The ASCII definitions of each key for the keyboard are contained 
in 116 consecutive RAM locations named KEYBUF. The upper shift 
keys are defined in the first 56 locations, followed by the 56 
lower shift keys. These memory locations form a 'map' of the 
physical keyboard. On power up, the HUNTER automatically 
defines these locations to a standard configuration. However, 
the programmer has the option to be able to define special 
keyboard arrangements. 

The schematic of the keyboard, see section 9.6 KEYBOARD MEMORY 
MAP, shows the value in KEYBUF for each key. 

It is important to note that on powering up HUNTER, the keyboard 
will revert to the standard version. The programmer should 
define the special keyboard requirements at an early stage in 
the program and ensure that the re-definition occurs each time 
the program is run. 

2.4.12 SPECIAL CODES 

Special codes are assigned to keys whose functions are: 

(1) Control key 

(2) Shift key (latched) 

(3) Help key 

(4) Momentary shift key 

(5) Power On/Off key 

(6) Virtual screen window up key 

(7) Virtual screen window down key 

(8) Virtual screen window right key 

(9) Virtual screen window left key 

(10) Virtual screen right 

(11) Virtual screen left 

(12) Label key 

(13) Insert key 
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In order for the operating system to detect a change of these 
keys, the SPELFLG location must be cleared. Changes modifying 
the special codes should only be done under software control. 

NOTE: 'Enter' is not a special code: it is simply CR (Decimal 
13 ) ! 

LATCHED SHIFT CODE 129 (81H) 

This key should be defined in both shift halves in order to 
function correctly! This function gives a 'toggle' action, 
changing shift with each operation. 

MOMENTARY SHIFT CODE 130 (82H) 

As HUNTER powers up in the lower shift, it is important for the 
momentary shift code to be defined in the lower shift half of 
KEYBUF. This function gives a 'conventional' shift requiring 
simultaneous depression of shift and the desired key. 

CONTROL CODE 132 (84H) 

On detection of this key the control code for the key pressed is 
derived from the code located in the upper shift half of KEYBUF, 
if this key has a valid 'control' equivalent. 

CONTROL CODE 133 (85H) 

On detection of this key the control code for the key pressed is 
derived from the code located in the lower shift half of KEYBUF, 
if this key has a valid 'control' equivalent. 

HELP CODE 134 (86H) 

The detection of this key causes the firmware to enter the HELP 
text mode. Help mode is exited by pressing the 'HELP' key 
again. 

ON/OFF CODE 136 (88H) 

The power on/off key may be relocated to any position on the 
keyboard. After HUNTER has been powered off the power key 
defaults back to the top right hand position of the keyboard. 

VIRTUAL SCREEN WINDOW UP CODE 138 (8AH) 

VIRTUAL SCREEN WINDOW DOWN CODE 139 (8BH) 

VIRTUAL SCREEN WINDOW RIGHT CODE 140 (8CH) 

VIRTUAL SCREEN WINDOW LEFT CODE 141 (8DH) 

The above keys allow the user to view the contents of the 
virtual screen. The keys are completely transparent to the user 
program. 

LABEL CODE 143 (8FH) 

Switches the function key display line on and off. The key is 
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transparent to the user program. 

INSERT CODE 144 (90H) 

Returns the virtual screen window to its original position after 
being moved by the window control keys. The key is transparent 
to the user program. 

2.4.13 ON/OFF KEY 

Unlike most computers, HUNTER'S ON/OFF switch is .not actually in 
control of power removal. The key is seen by the software 
scanning the keyboard and the actual decision to turn off is up 
to the software itself. • 

If a machine code program places HUNTER into an endless loop, it 
will be impossible to turn off the machine. This may be 
overcome by removing the main batteries. 
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SCREEN 


2.5.1 HUNTER has a large LCD (Liquid Crystal Display) screen. It can 
present up to 320 characters on 8 lines of 40 characters each, 
just like a small video terminal. 

The character set includes upper and lower case alphabets and 
special characters. Additionally, a graphics display of 240 x 
64 pixels is supported. 

HUNTER'S display is designed for use in bright sunlight where 
other displays (the red 'LED' or green 'vacuum flourescent', for 
example) become invisible. 

Because it works by contrast, rather than emitting its own 
light, it is perfectly visible no matter how bright the light 
is. But a word of caution: try to avoid leaving HUNTER exposed 
to direct sunlight for prolonged periods - the delicate 
chemicals in the LCD can be damaged. 

The 'Cursor' shows where data entered on the keyboard will 
appear. 

The screen is protected by an acrylic window, as strong as 
glass. Like glass, it can be scratched, so please take care. The 
window should only be cleaned with chamois or lens cleaning 
cloth. 

HUNTER is built to last - please take care of it. 

2.5.2 SCREEN MODES 

The screen can be used in two ways: 

: Text mode 
: Graphics mode 

Text mode provides only character support with the standard 8 
lines of 40 characters displayed. Internally, there is a 
"virtual screen", see section 2.6, supporting 24 lines of 80 
characters. This mode can support any standard CP/M program, 
e.g. SuperCalc or dBase II. It can be used in this fashion due 
to the speed at which the E.CD screen can be refreshed in this 
mode. This is the only mode supported for CP/M based programs. 

Graphics mode will support characters of five different sizes, 
reverse video and full graphic capabilities. There is no 
"virtual screen" associated with this mode. It is only 
supported from Basic, see section 5. 
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2.5.3 Screen Control 

The text screen will support "clear" and screen addressing. The 
screen is addressed throughout the virtual screen, that is the 
addressing range is from 0 to 79 horizontally and 0 to 23 
vertically. 

Cursor addressing is a three character sequence sent to the 
screen handler. It is of the form: 

Cursor addr control, x-coordinate, y -coordinate 

The cursor address conrol is OFH (15 dec). 

The x coordinate is a number 0 - 79. 

The y coordinate is a number 0 - 23. 

The screen may be cleared by sending a control A or 01H 
character to the screen handler. 
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VIRTUAL SCREEN 


2.6 The eight by forty characters on the LCD are only one sixth of 

the number of characters contained within the virtual screen. 
The LCD acts as a window onto the virtual screen. The contents 
of the virtual screen may be inspected at will by using the 
cursor control keys in their shifted state. 


2.6.1 SCREEN SIZE 

HUNTER'S virtual screen is 80 characters by 24 lines. The 
virtual screen behaves very much like a terminal with automatic 
scrolling. When the cursor reaches the bottom line, the rest 
scrolls up losing the top line. 


2.6.2 MOVING THE WINDOW 

The window may be moved over the virtual screen either manually 
by the user, or automatically by the virtual screen handler 
resident in the operating system and as such is transparent to 
the user. 

2. 6 . 2.1 Manual Movement 

1) Shifted state cursor control keys (looking keys): 

By using the cursor control keys in their shifted state, the 
windovi can be made to move in the direction marked on the key, 
i.e. press the 'shift' key, hold it down, arid then press the 
desired cursor control key. When this operation is performed it 
will be noticed that the cursor on the LCD (a blank flashing 
block) will change its position on the LCD and quite often 
disappear. This will happen because the cursor position refers 
to the position in the virtual screen, and when the window is 
moved the cursor position relative to the window position in the 
virtual screen will change. 

2) Function "cursor control keys" 

By pressing CTL/FN and either horizontal arrow key, then either 
the left or right 40 characters of the screen can be seen. Unis 
function is useful for easy reading of wide screen formats. 

3) ’INS' Key: 

Pressing the INS key will return the window to its original 
position prior to use of the looking keys, as outlined in (1) 
above. 
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4) Transparent Movement: 

The transparent movement of the virtual screen window is 
primarily controlled by inputs, both from the keyboard and the 
serial port. If HUNTER is required to accept an input from, 
say, the keyboard then the window will automatically be moved to 
allow the viewing of the immediate area of the virtual screen 
centred around the present cursor position, thus displaying any 
prompts which may have been required by either a Basic program 
or a CP/M type program. 

It must be noted that printing text onto the virtual screen will 
not move the window. However, if any part of the virtual screen 
which is presently in view on the LCD is changed by, say, a 
PRINT statement, then these changes will be reflected on the 
LCD, thus always giving a true representation of the virtual 
screen. 

If HUNTER is accepting input from the keyboard and the cursor 
reaches the forty-first position of the virtual screen, then the 
window will be moved laterally so that the cursor is now 
positioned mid-way across the LCD, as soon as the forty-first 
character is entered, thus displaying the previous 20 virtual 
screen characters and the following 20 virtual screen 
characters. 

If HUNTER is waiting for input and the looking keys are used to 
move the window, a valid input will cause the window to 
automatically revert to its original position prior to the use 
of the looking keys. This facility does not force the user to 
press the 'INS' key in order to restore the original position of 
the window when in this mode. 

For further information on cursor addressing see LOCATE in Part 
5, BASIC FUNCTIONS and section 2.5.3. 


NOTE: The virtual screen window does not operate in Graphics 
mode. 


2.6.3 MOVING THE CURSOR 

To move the cursor in the required direction it is only 
necessary to press the appropriate cursor control key. 
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Fig 2.4 VIRTUAL SCREEN 



note: The shifted cursor control keys move the 

window over the virtual screen in the direction 
of the arrows. 
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COMMUNICATION 


2.7 HUNTER has an industry-standard RS-232/V24 serial communications 

port, and will talk directly to most computer peripherals, 
modems and other devices. 

Fig 2.5 MALE (HUNTER) 



The port communicates via a standard male 25-way *D* type 
connector. The pin connections and other data are detailed in 
Part 6, COMMUNICATIONS. 

NOTE: Never, never try to force a mating connector home. Check 
that the connector is the right way up (like this): 

Fig 2.6 FEMALE (CABLE) 


• • • • 

25 24 23 22 


• • 
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If the connector won’t fit easily, it probably won't fit at all. 

FIND OUT WHY 

HUNTER's communication format is usually set up by its 
applications program for specific situations, and does not 
require operator attention. 

Sometimes, a user program will present a 'menu'selection for 
operator choice. In this event, selection of the desired 
communications mode will automatically set the communications 
parameters without further action. 

Communications parameters can also be set manually. An internal 
program, 'COMMUNICATIONS PARAMETERS', can be accessed or called 
by a user application program. See Part 6 COMMUNICATION, for 
details. 
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Fig 2.7 BATTERY INSTALLATION 
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BATTERIES 


2.8 HUNTER is battery powered. It runs for a long time on a set of 

standard 'AA' size cells obtainable anywhere. 

A second rechargeable battery is permanently built into HUNTER 
so data is not lost even if the main batteries are removed. This 
battery should never need to be replaced. 

2.8.1 BATTERY INSTALLATION 

The batteries are spring-loaded to make contact and retained by 
a threaded plug. When installing batteries, follow this 
procedure:- 

1. ONLY USE A COIN in the battery plug. Screwdrivers, 
etc., will damage the slot and HUNTER'S appearance. 

2. Feed in the cells, positive inwards. Don't <J.rop the 
'AA' cells in vertically - they can be damaged. 
Instead, slope HUNTER slightly. 

3. Take the battery plug and, with finger pressure only, 
press into the battery compartment and turn. 

4. Only when the thread is started, use a coin to screw the 
plug home. 

The battery plug should stand about 2mm proud from the case 
wall. 

NOTE: Clockwise inserts the plug 

Anti-clockwise removes the plug 


2.8.2 MAIN BATTERY - PRIMARY 

We strongly recommend the use of Alkaline-Manganese batteries 
similiar to Mallory MN150Q. 

We do not recommend the use of cheaper zinc-carbon cells for 
routine operation, since these can suffer electrolyte leakage, 
have shorter lives and can introduce technical problems. 

Alkaline cells will produce approximately 45 hours of HUNTER use 
when running a typical application program, and almost 
Indefinite storage life. There is no need to remove cells from 
HUNTER during storage or shipment but remember that capacity 
will reduce with time. 
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2.8.3 BATTERY - RECHARGEABLE 

Only Nickel-Cadmium (Ni-Cd) cells are to be used. Under no 
circumstances must any other type of rechargeable cell be installed. 
We recommend Berec type NCC50 cells of 500 mAH capacity. 

2.8.A Low Battery Warning 

HUNTER is designed to provide adequate warning of impending battery 
failure and will protect user's data, even in the worst situations. 
This warning facility has been improved in Hunter operating systems 
Ver.9G onwards. 

When HUNTER'S batteries become low, HUNTER will give warnings to the 
user. Since it is usually essential that all data and programs are 
secured, it is recommended that HUNTER is switched off as soon as 
practicable and the batteries either replaced with a fresh set or, if 
rechargeables are fitted, put on charge. 

Low Battery warnings are repeated as follows: 

a) every 5 seconds if the HUNTER is switched on, but quiescent, 

b) after every keyboard key depression 
or, 

c) every 0.5 seconds if characters are being received on the RS232 
port. 

If ten consequentive warnings are ignored, HUNTER automatically 
switches off. When this occurs, HUNTER is placed automatically in a 
CONT mode (see section 3.4.3.4). This means that when power is 
restored, program execution will continue from precisely where it was 
prior to the interruption. 

HUNTER has two screen modes, text and graphic (see section 2.5). 
Battery low warning is slightly different in the two modes: 

a) Text Mode 

When a low battery is detected, the top line of the screen 
displays: 

* WARNING BATTERIES ARE LOW * 

HUNTER bleeps twice and then the original text is restored until 
the next warning. 
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The text screen contents are preserved and not affected by the 
warnings. Following power restoration, the screen is restored 
to its pre-warning state. 

b) Graphics Mode 

When a low battery is detected, the top line of the screen 
displays: 

* WARNING BATTERIES ARE LOW * 

in reverse video and using the smallest character set (CHARO). 
This message stays on the screen between battery warnings. 
HUNTER also bleeps twice. The warning message destructively 
overwrites the top line of the screen, the contents of which are 
lost and must be restored by the user's program. 

If an attempt is made to use HUNTER without replacing or recharging 
the batteries, Battery Low warning is displayed and HUNTER 
immediately turns off again. It is worth commenting that flat 
batteries can partially recover after being switched off such that 
operation could continue for a short period. It is not recommended 
that this should be done in practise, particularly with rechargeable 
batteries which could then become totally exhausted. In the case of 
Ni-Cd batteries, this can lead to permanent damage to the cells. 


2.8.5 POWER SAVE 

An automatic power conservation system has been incorporated into 
HUNTER, enabling the power to be removed from circuits when they are 
not in use. 

Usually, the computer will enter power save mode whenever it is 
awaiting a keyboard entry. However, a few programs defeat this 
facility by not using standard CP/M console calls and have a 
correspondingly higher overall power consumption. Please consult 
Husky Computers for advice in specific cases. 

2.8.6 BATTERY CHARGING 

HUNTER is optionally available with rechargeable cells and a mains 
(line) powered charger. 

This arrangement allows cells to be recharged in HUNTER, and for 
alkaline cells to be quickly substituted if the user forgets to 
recharge! 

But BE CAREFUL - NEVER connect the charger when alkaline batteries 
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are installed. They will NOT re-charge. Instead, they may explode, 
jam in the battery tube or leak corrosive chemicals. 

See section, 8.6, BATTERY CHARGER, for further information regarding 
the use of HUNTER'S battery charger. 

2.8.7 CONTINUOUS CONNECTION 

HUNTER can be powered permanently from the charger by simply leaving 
the unit connected. In this mode, the rechargeable cells will be kept 
'topped up' by the charger despite the continuous current drain. Of 
course, a fully discharged battery will take longer to recover than 
if HUNTER is powered down. 


2.8.8 Auto Timeout 

To conserve battery life, HUNTER will automatically switch off after 
a period of inactivity. A warning bleep is emitted every 2.1/2 
minutes to remind the user that HUNTER is turned on. This timeout 
does not operate in Terminal Emulation (see section 6.8). The 
timeout value can be modified using POWER in Basic (see section 
5.17.7) and has a default value of 5 minutes. 
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2.9.1 


PANIC- 


HUNTER is designed, built and quality tested for robustness in 
every sense including robustness of program execution. 

HUNTER'S microprocessor system has wide design tolerances (much 
more than conventional computers) to guarantee absolutely 
reliable execution of millions upon millions of machine-code 
instructions every hour. Its physical construction protects it 
against mechanical disturbance, while the conventional 
computer's Achilles heel - external electrical interference - is 
virtually eliminated. 

Because of these factors, HUNTER is most unlikely ever to mis- 
execute a user's program or behave in a way that is not 
thoroughly predictable, given sufficient insight. 

CRASHES 


However, there are some specific situations that can cause 
HUNTER to mis-execute its internal programming, or "Crash". 

The commonest causes are: 


2.9.2.1 Illegal System Calls 

System calls from Basic are not 'trapped' (this would restrict 
user programming) and can cause mis-execution if not valid. 

2.9.2.2 Invalid user machine code 


User assembly-level programs or subroutines can easily cause 
mis-execution by containing, for instance, invalid jump 
instructions. 


2.9.2.3 Physical degradation 

Ingress of water, corrosion of internal parts, damage to 
components through excessive shock or persistent high level 
vibration can reduce electronic tolerances. 


2.9.2.4 Operation outside specified temperature range 

HUNTER is specified for operation in the range 0 to 55°C. 
Operation above 55°C reduces tolerances, while below 0°C battery 
capacity becomes severely restricted. Sub-zero temperatures 
also slow LCD screen response time substantially. HUNTER is 
unlikely to mis-execute program simply because of low 
temperatures, however, in the range 0°C to -20°C. 
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2.9.3 SYMPTOMS 

"Crashes" are identified by these symptoms: 

2.9.3.1 Keyboard Lock-out 

HUNTER'S keyboard is entirely "soft" to allow user re-definition 
of key functions, including the power key. If HUNTER'S internal 
program is caused to 'Crash', power control may be lost, HUNTER 
will not switch off. 

2.9.3.2 Clock wipe-out 

Following a mis-execution episode, HUNTER'S calendar clock 
registers may be corrupted. 

2.9.3.3 Program Corruption 

The most serious consequence of mis-execution is when the micro 
processor runs 'wild', writing data randomly to all parts of 
memory and, occasionally, corrupting user programs. This failure 
is generally catastrophic, and is unlikely to go undetected. The 
most likely consequence is that any attempt to 'RUN' the 
corrupted program will result in keyboard lock-out (see above). 
Attempts to 'LIST' corrupted programs may also result in lock¬ 
out. 

2.9.3.9 I/O Corruption 

I/O selections may be affected by mis-executions in a random 
fashion. In some cases spurious options may appear in the 
parameter selection screens after a 'Crash'. In this event, 
hold down one of the cursor control keys until recognisable 
options appear. 


2.9.4 RECOVERY 
2.9.4.1 Program Corruption 

If a mis-execution has occurred, any user program stored in RAM 
memory must be viewed with suspicion. The safest solution, 
assuming that the use of keyboard is still available, is to type 
'NEW', followed by re-loading of the program. 

Remember that even 'LIST' may result in keyboard lockout, 
although holding the power key down will generally restore 
control eventually. 
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Most types of corruption (corrupted lines, spurious line 
numbers) are unrecoverable in Basic and can only be eliminated 
by 'NEW'. 

2.9.4.2 Keyboard Lock-out 

If keyboard lock-out (failure to power down) occurs, it is 
necessary to power down HUNTER by removing the battery cap. 

HUNTER should power-up again normally. If desired, try running 
the user program, but be ready to clear any lock-out that occurs 
using the above methods. If lock-out persists, type 'NEW' after 
restoring operation. 

2.9.4.3 System Lock-out 

In very rare cases, HUNTER may fail to restart correctly after a 
mis-execution episode. This is possible in a program that uses 
auto-start, see section ^4.12, AUTO POWER FEATURE, and contains 
an invalid system call. 

Any program corruption resulting could leave the auto-start flag 
set, but cause a lock-out when power-up is attempted. 

The solution is to apply the 'ESC' sequence immediately after 
power-up, in order to reset the auto-start flag. 

2.9.**.4 File corruption 

Because files are not stored in Hunter's workspace (RO) area, 
mis-execution episodes are much less likely to cause corruption 
of this part of memory. In any case, the checksum facility 
will indicate if damage has ocurred. Current experience 
suggests that storing a 'back up' file in a different memory 
page virtually guarantees data integrity against the worst 
possible disasters. 

A checksum error can result in a "no file" message being 
displayed in response to an attempt to use the file, even if the 
directory entry is present. In this event, the only recourse is 
to re-load the file. 
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2.10 

2 . 10.1 


2 . 10.2 


2.10.3 


BATTERY LIFE 

HUNTER'S power control system is designed to optimise battery life by 
adapting power consumption to the computer's level of activity. This 
means that power consumption varies according to the level and nature 
of use, making calculations of battery life slightly more complex 
than usual. However, if it is known how long HUNTER will be used in 
its different modes, it is possible to calculate with reasonable 
accuracy the expected life of a set of batteries. 

Battery capacity is measured in mAH (milliamp hours) and by knowing 
the battery type in use, life may be calculated. 

Battery capacity is affected by a number of factors including age, 
charging method, ambient temperature, etc. However, the capacity 
typically available from the two types of battery used by HUNTER is 
as follows: 

a) DISPOSABLE Duracell type MN1500 (I.E.C. LR6) capacity 900 

mAH. 

b) RECHARGEABLE Berec type NCC50 (I.E.C. KR 15/51) capacity 425 

mAH. 


Because capacity can vary significantly, the application planning 
should always assume reduced available capacity. There are no firm 
guidelines for this, but 50% of capacity is considered conservative. 

A factor affecting apparent battery life is the "end point", or 
voltage at which the battery is considered to be exhausted. Hunter 
sets this end point at 4.6 - 4,8 volts for battery warning. 

This value yields virtually 100% of Nickel Cadmium batteries capacity 
and gives good results for Alkaline cells, but means that 
manufacturer's specifications for capacity may some times be 
misleading. 

HUNTER'S power consumption has three principal modes: 

a) POWER SAVE 15mA 

(awaiting keyboard or serial port entry) 

b) OPERATING 90mA (208K) 

(running a program for calculation, data storage, screen updat¬ 
ing or any operation involving continuous execution of user 
program). 
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c) COMMUNICATING 

(connected to a fully equipped 125mA (208K) 

RS232 port and 115mA (80K) 

operating) 

As can be seen, the POWER SAVE current is very low. Although the 
screen is on and the keyboard responsive to any key depression, this 
is the condition in which HUNTER is expected to be most of the time. 

A typical application example might be a salesman using HUNTER for 
order entry purposes at a number of customer's premises and returning 
to base for communication. 

2.10,4 Example of Power Consumption 

The day is 7.5 hours long, during which he makes five calls. At each 
call he uses HUNTER for 40 minutes for stock checking and order entry 
purposes. The communication time takes 15 minutes, with a further 5 
minutes left powered up. 

Of the 40 minutes use at each call, only 5 minutes is considered 
'operation' since most of the time HUNTER is waiting for keyboard 
entry. 

Each Visit 


Operating Power 80 x 5 

60 

Power Save Power 15 x 35 

60 

Total Visit Power 
Total Day's Power: 

5 visits at 15.4mHA 
Communicating 115 x 15 

60 

Waiting after corns 40 x 5 

60 


6.67 mAH 

8.75 mAH 

15.4 mAH 

77 mAH 

28.75 mAH 

3.33 mAH 
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Day Total = 109 mAH 

Total Time in use through the day: 3 hours 40 minutes. 

It would be expected that the HUNTER would last approximately 4 days 
(or 14 hours 40 minutes total) on a set of rechargeable cells. 
Alternatively, HUNTER would last 10 days (or 36 hours 40 minutes) on 
a set of manganse alkaline cells. 
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This illustrates a period of use of the HUNTER. In practise, the 
periods of power save are much longer than that illustrated. 
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DEMOS - FILE MANAGER 


3.1 HiJNTEH's file manager DEMOS (Disc EMulation Operating System) 

manipulates files and runs CP/M programs. A .large range of 
commercially available CP/M software will run on HUNTER with no 
modification 

After switching HUNTER on, the 'Welcome Message' is displayed 
and the following screen can be obtained by pressing any key: 


20 Jan 

1984 13:04:2? 

»*DEMOS VER 

2.2 9.A** 

BAS .sys 

CCMS ,sys CLCK .sys 

TERM .sys 

EDIT .sys 

DIR STAT BAS 

COMS CLCK TERM EDIT KEYS 


The bottom line shows the titles of the soft keys. See section 

2.2, FILE MANAGER DISPLAY. 

The File Manager has several important functions: 

(1) All programs such as word processors, spreadsheets and the 
Basic Interpreter are run from the File Manager. 

(2) Various system files can be selected, for example, setting 
up the communication protocols. 

(3) Information on the size of the files present (STAT) or file 
operations like transmitting a file (SEND) can be 
performed. 
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3.1.1 FILE NAMES 

Files are named following the general format of CP/M. They 
consist of up to eight alphanumeric characters separated by a 
period from an extension of three alphanumeric characters. The 
extension informs the operating system of the type of file, if 
the user so wishes. Generally, the extensions follow the'se 
conventions: 

•HBA - HUNTER Basic file containing program source code. 

.COM - A CP/M compatible object code file which can be 
loaded and run independently of HUNTER Basic. 

,DTA - HUNTER Basic data file. 

.TXT - Any ASCII text file. 

.SYS - A 'psuedo file 1 , generally in ROM. 

3.1.2 KEYBOARD COMMANDS 

By use of the control key together with another key the editing 
functions, see TABLE 3.1 KEYBOARD COMMANDS, can be implemented 
under the File Manager: 

TABLE 3.1 KEYBOARD COMMANDS 

'control C' - Reboots when at the beginning of the line, 
'control E' - Causes physical end of line. 

'control H' - Backspace one character position. 

'control J' - (Line feed) terminates input line. 

'control M' - (Return) terminates input line. 

'control R' - Retypes the current line after new line. 

'control U' - Removes current line after new line. 

'control X' - Backspace to beginning of current line. 
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PROGRAM EXECUTION 


3.2 CP/M, and HUNTER Basic programs may be run from tine File 

Manager. In both cases the program is loaded into the working 
RAM page and executed either under the Basic interpreter or 
directly. CP/M and Basic program files are stored together in 
RAM file space, and are treated as if they were stored on disk. 

3.2.1 BASIC PROGRAMS 

HUNTER Basic programs can be run without explicitly invoking the 
interpreter. Entering a filename which has the .HBA extension 
will cause the Basic program to be loaded and the interpreter to 
be executed. For example, if the directory reads as follows: 

>DIR 

PR0G1 .HBA WORDS .COM PROG2 .HBA 
NAMES .TXT 


Then typing: 

>PR0G1.HBA 

executes the HUNTER Basic program PR0G1.H3A. The file extension 
.HBA must be specified. To enter the Basic interpreter use the 
File Manager command 'BAS', function key 3. See Part A, BASIC 
PROGRAMMING, for further information on HUNTER Basic. 

3.2.2 CP/M PROGRAMS 

Object code files with .COM extensions may be executed in the 
standard CP/M manner. The filename entered, for example using 
the directory above: 

>W0RDSC.COM] 

will cause the program to load and run. The .COM file extension 
is optional. 
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FILE STRUCTURE AND MEMORY ORGANISATION 


3.3.1 HUNTER is capable of storing a great deal of differing infor¬ 
mation within its large memory. There may be Basic programs, 
text files, data files or object code CP/M programs. 

Superficially the operating system handles its memory in a 
similar manner to disk backing stores, and indeed may be 
considered as a 'RAM Disk'. However HUNTER is much faster than 
any disk system and incorporates special facilities to enable 
the memory to be efficiently utilised. 

HUNTER'S File Manager DEMOS (Disk EMulation Operating System) 
manipulates files and runs CP/M programs. The File Manager 
environment is totally unconnected with Basic. 

3.3.2 ENVIRONMENT AMD STRUCTURE 

The File Manager facility is located in firmware, so there is no 
overwriting of existing programs in execution RAM. A CP/M call 
0, or a JMP 0000 both cause a "warm" start which executes the 
File Manager in ROM. This would be a typical method of ending a 
.COM program. Entering the File Manager on power up is 
equivalent to a "cold" start, in which the operating system is 
completely reset, although programs in R0 are preserved. 

HUNTER'S File Manager will implement several commands and load 
and execute .COM files. Files may be erased, renamed or saved 
from memory, ASCII files may be displayed on the screen, as can 
the file directory. Finally, there is a facility for loading and 
dumping the files via the serial port in either Intel hex format 
or 8 bit binary format. 

The File Manager is structured around the CP/M compatible 
operating system and file structure. The RAM filespace, 
organised in exactly the same manner as disk based files, can 
be accessed through the system calls. Utility commands can be 
quickly selected from the soft keys. 


3.3.3 FILE SPACE 

Files are stored, as on magnetic disk, in records of 128 bytes, 
grouped by 16's into 2K bytes. This means that the smallest 
file size is 2K bytes, but, as with magnetic media, allows for 
very large files to be stored. 

The memory space is allocated by the file manager and is 
transparent to the user. 
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3.3.4 FILE ERRORS 

Each time a file is modified an error checksum is calculated and 
stored in the directory. This operation is completely 
transparent, as is each accuracy check when the file is accessed 
for reading or executing. If any discrepancy is found then a 
"no file" message is displayed. 

3.3.5 HUNTER MEMORY ORGANISATION 

HUNTER is designed for very large RAM memories and 48k ROM, see 
Fig 3.1, HUNTER MEMORY MAP and Fig 3.2, HUNTER FILE ACCESS. The 
memory is organised into pages: one page of ROM operating 
system, one page of RAM execution memory and further pages of 
RAM file space. All pages except for RO, the execution memory 
(also known as the Transient Program Area, or TPA) are limited 
to 48k. RO extends to 54k, although the top 6k together with the 
10k of common RAM are never paged out. There is, therefore, up 
to 54k of RAM for programming. 

Common RAM, see Fig 3.3, SYSTEM RAM MEMORY MAP, is used to link 
together the various pages of RAM and ROM. It organises the 
paging and contains the jump tables for CP/M compatibility. The 
'operation of paging is totally transparent to the user so HUNTER 
'is seen to have 54k program space with a powerful 48k operating 
system and Basic interpreter in ROM, and a block of file space. 

3.3.6 BASIC PROGRAMMING 

Since the Basic interpreter resides in ROM, the whole 54k of RO 
is available for a Basic source program, variables and arrays. 
Simple variables are stored with the source program and Basic 
may access files for further storage. 


3.3.7 CP/M PROGRAMMING 

-Object code programs must be executed from RO. Again, there is 
54k RAM available for the program, plus the file space. 
Normally, the program will reside in the HUNTER as a .COM file, 
and will be loaded and run by the File Manager. However, the 
File Manager is very versatile, and provides flexibility in 
file manipulation and execution. 
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3.3.8 FILE ORGANISATION 

The pages reserved for file storage have, as magnetic media, a 
"sector allocation map" and the actual directory, split into 16K 
extents. Any good text on CP/M file storage will give an 
adequate explanation, which is also true for HUNTER. 

This means that 2K byte blocks of a file are in no particular 
order within the filespace RAM, making large files and fast 
updating possible. 


Fig 3.1 HUNTER MEMORY MAP 
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Fig 3.3 SYSTEM RAM MEMORY MAP 
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FILE MANAGER COMMANDS 


3.4.1 PROMPT 

The prompt character, which is displayed when the File Manager 
is ready to receive a command, is the greater than sign ■>'. If 
this is not displayed, then no input is expected. 

3.4.2 COMMAND SYNTAX 

Commands are typed in with their arguments (usually filenames) 
separated by spaces. Wildcard characters may be specified. 
Commands may be in upper or lower case alphabetic characters. 


3.4.3 WILDCARDS 

DEMOS supports the use of wildcards '?' and **'. The '?' 
character will allow DEMOS to search for file names and 
disregard the characters replaced with For example, suppose, 
there are five files with the names FILE1.TXT - FILE5.TXT. The 
following DIR command would only list those files: 

>DIR FILE7.TXT 

FILE1.TXT FILE2.TXT FILE3.TXT 
FILE4.TXT FILE5.TXT 

or 

>DIR A7FILE.COM 

AAFILE.COM ACFILE.COM A4FILE.COM 

The wildcard replaces the entire extension or file name. The 
example below will list all files with the extension .HBA: 

>DIR *.HBA 

PROG1.HBA PR0G2.HBA START.HBA 
or 

>DIR MYFILE.* 

MYFILE.TXT MYFILE.COM MYFILE.HBA 

To list all the files held in HUNTER the command 'DIR' is used. 
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A combination of wildcards can also be used: 

>DIR ??FILE.* 

MYFILE.TXT MYFILE.COM MYFILE.HBA 
AAFILE.COM ACFILE.COM A4FILE.COM 
MRFILE.HBA 

Wildcards may be used with other File Manager commands apart 
from DIR, for instance, as follows with the ERA command: 

>ERA BIG*.* 

this will erase any file starting with 'BIG' and any extension 
for example, BIGER.FIL, BIG.HBA or BIGGLES.COM would all be 
deleted. 

Note that, as a precaution, Hunter will query the erasure of 
each file in turn, requiring operator confirmation at each 
stage. 
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3.4.3.1 COMMAND : 

EXPLANATION : 

EXAMPLES : 


REMARKS 


BAS 


BAS 

Execute HUNTER'S Basic interpreter. 

When the Basic interpreter has been entered the 
following screen is displayed: 

'Hunter Basic Interpreter i 

|READY ! 

i i 

i i 

■ i 

i i 

i t 

i i 

i i 

t i 

i i 

i i 

|File Run Edit List Save Load Kill Systj 


HUNTER'S Basic interpreter is executed from 
ROM. If the last program was a CP/M program 
then an automatic NEW resets Basic, otherwise 
any Basic programs remain as before. Variables 
also remain unaffected. For complete 
information on Basic programming refer to Part 
4, BASIC PROGRAMMING. 
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CLCK 


3.4.3.2 COMMAND : CLCK 


EXPLANATION : Set the internal calendar clock to the desired 
date and time. 

EXAMPLES : Calendar clock initialisation screen: 


13 Oct 1983 11:55:00 

Time setting mode 


REMARKS : To set the internal calendar clock proceed as 
follows: 

a) Using the cursor right and cursor left keys, 
step the cursor to the item you wish to set. 
The seconds cannot be set and are always 
initialised to zero when synchronising the 
clock (see below). 

b) Using the cursor up and cursor down keys, 
step the value selected until it is correct. 

The months step in the following manner:- 

Nov, Dec, Jan etc. ; Cursor up 
Jan, Dec, Nov etc. ; Cursor down 

c) Set the 'minutes' to one minute ahead of the 
present time. 

d) Press 'Enter'. HUNTER will display:- 
'Press ENTER to synchronise' 

e) When the time code, pip tone, or other 
reference arrives press ENTER, 

HUNTER'S clock will run from zero seconds in 
exact synchronisation with the external 
reference. 

f) The calendar automatically accounts for leap 
years. 


VER.V09F 


PAGE 3-12 




SECTION 3.4 


FILE MANAGER 


g) If an attempt is made to specify an 
incorrect day value, e.g. 31 st April, HUNTER 
will display the waming:- 

Error - Incorrect day value 

The error must be corrected before synchroni¬ 
sing the clock. 

HUNTER'S clock can be used to time-stamp 
entries, automatically label printouts or even 
initiate program execution automatically like 
an alarm clock. 

See Part 5, BASIC FUNCTIONS, for details on 
TIME$, DAY$ and DATE$ functions and Section 
3.5.3.40 and 3.5.3.47 for details of CP/M clock 
calls. 
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COMS 


3.4.3.3 COMMAND : COMS 

EXPLANATION z Initialise the communications parameters. 

EXAMPLES : Two screens are used to select the 
communications parameters as follows: 



REMARKS : See section 6.4, COMMUNICATIONS PORT SOFTWARE, 
for information on selecting communication 
parameters. 

NOTE: Communication parameters are not reset 
when HUNTER is powered off. 

In CP/M, the serial communications interface is 
assigned the following logical devices: 

Transmit - LST:, PUN: 

Receive - RDR: 
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3.4.3.4 COMMA® : 

EXPLANATION : 

EXAMPLES 


REMARKS 


CONT 


COST filename 


Execute program with 'continue' option. 


: >CONT PROG1.COM 


This will load and run the CP/M program 
'PROG1.COM'. 

The three character file type extension does not 
have to be specified for .COM files but must be 
included for HUNTER Basic files, for example, a 
HUNTER Basic program has the name 'SORT.HBA', 
the following would load and execute the program 
via the Basic interpreter: 

>C0NT SORT.HBA 


If at any time during execution of a program 
initiated with 'CONI', HUNTER is switched off or 
power down takes place, switching HUNTER on will 
cause the program to continue execution from the 
point at which power was removed. 

Escape from 'CONT' mode during program execution 
is made by pressing 'Control C' when power is. 
off , and then pressing 'pwr' to power on while 
keeping 'Control C' depressed. Two 'beeps' 
should be heard, when the keys should be 
released. Then enter the special security 
number, the default for which is 56580. 

If an error is made, the Hunter will 'beep' and 
return to program execution. 
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3.4. 3. 5 COMMAND : DIR [filename] 


EXPLANATION : Display the file directory. 


EXAMPLES : >DIR 

ONEPROG.HBA TWOPROG.COM FINAL.HEX 
ANOTHER.1 


DIR can also be used with wildcards as follows: 
>DIR FILE7.TXT 

FILE1.TXT FILE2.TXT FILE3.TXT 
FILE4.TXT FILE5.TXT 


or 

>DIR A7FILE.COM 

AAFILE.COM ACFILE.COM A4FILE.COM 


or 

>DIR *.HBA 

PR0G1.HBA PR0G2.HBA START .HBA 


REMARKS : A combination of wildcard characters can also be 
used. 

If the directory is too long to fit on the 
display screen then use of the cursor control 
keys can scroll back the virtual screen to see 
the earlier entries. 

The virtual screen contains 24 lines, if a file 
directory extends to more than 24 lines, the top 
lines will scroll off the screen. Use of 
wildcards may help in limiting the number of 
directory lines displayed. 
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3.4.3.6 COMMAND 


EXPLANATION : 


EXAMPLES 


REMARKS 


EDIT 


EDIT [filename] 


Edits either ASCII text or Husky Basic (.HBA) 
files. 


>EDIT PROG 1.HBA 

This will edit a Husky Basic file. 

>EDIT TEXT 

This command will edit on ASCII file TEXT.TXT. 
The .TXT is defaulted. 

>EDIT NEWS.DAY 

Edit the ASCII file of the above name. 


Further information on the editor can be found 
in section 7. 
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3.4.3.7 COMMAND : ERA filename 


EXPLANATION : Erase the specified file. 


EXAMPLES : >ERA MYFILE.HBA 

ERA may also be used with wildcards as follows: 
>ERA MY*.* 

will erase any files starting with 'MY' and any 
extension. 


REMARKS : Each filename will be displayed and the user has 
the option to enter 'Y 1 to delete the file or 
’N’ to retain the file. If wild cards have been 
specified the next filename is displayed. Due to 
the nature of the 'RAM disk', the files can at 
no stage be recovered. 


VER.V09F 


PAGE 3-18 



FILE MANAGER 


SECTION 3.4 


3.4.3.8 COMMAND : 

EXPLANATION : 

EXAMPLES : 

REMARKS : 


EXECUTE 


EXECUTE 


Executes the current program in executable RAM 
page 0. 


>EXECUTE 

>execute 


This command will normally only be used after 
LOADing a program or after using the INP 
command. However once a program has been loaded 
and if it does not alter itself in any way, 
EXECUTE will execute it again without having to 
re-load the program. 
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3.4.3.9 COMMAND : FORMAT 


EXPLANATION : Re-sets HUNTER'S filing system. 


EXAMPLES : >FORMAT 

FORMAT?: Are you sure (Y/N) 


REMARKS : When FORMAT is executed all files are deleted 
from HUNTER’S memory, leaving the user with only 
the built-in system files. This command should 
be used with caution. It is generally only 
required if a machine code program loaded into 
HUNTER has crashed causing destruction of files 
and directories. 

If ’Y' is typed in response to the above 
question the File Manager will re-set HUNTER’S 
filing system. Any files in the storage area 
will be lost. Also any programs loaded into the 
Basic workspace are deleted. 

If any other character is typed HUNTER will 
return to the File Manager. 
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INP 


3.4.3.10 COMMAND : INP tn filename] 


EXPLANATION : Inputs a file via the serial port. 


EXAMPLE : INP can be used to load files in either Intel 
Hex format, with checksums etc., or as 8-bit 
data but without any error checking. The second 
method of loading is, however, faster than using 
Intel Hex. 

(1) Loading Intel Hex files 

Files to be loaded must be in Intel Hex format, 
see section 9.11, HEX DATA FORMAT. If they are 
command files, overlay files or data files etc., 
this is achieved with a standard utility 
reproduced in section 9.5, DEMONSTRATION 
PROGRAMS. 

Typing INP readies HUNTER to receive data, which 
is put into RAM page 0. The data is not written 
directly into a file. When completed the number 
of 256 byte blocks loaded is displayed. It may 
be copied to a file using the SAVE command, or 
if it is a program, executed with the Execute 
command. 

(2) Loading 8-bit format. 

Data is loaded directly into a specified file in 
blocks of 256 bytes. The format of the command 
is: 


INP n filename 

For example a 14k overlay file: 

>INP 56 OVERLAYI.OVR 

The communications must have parity set to 8-bit 
and SERIG (Serial ignore character) set to off. 

The number of blocks must be specified because 
there is no end of file character. If too many 
blocks are expected, the screen will display 
'waiting', and reception may be terminated with 
'ESC'. 
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REMARKS 


: When HUNTER is loading data the following 
messages will appear on the screen: 

>WAITING 

>LOADING 

>WAITING 

>L0ADING 


HUNTER responds to each pause in transmission 
with a 'WAITING' message to indicate that data 
is not being received. 

On completion of Hex loading the number of 256 
byte blocks now in memory is displayed. 

The number of blocks, n, can be overspecified. 
For instance: 

INP 100 filename 

will load most files. Only the number of blocks 
actually required will be used following 
termination by 'ESC’. 

The number of blocks is calculated by: 

1 block = 256 bytes 
IK bytes = 4 blocks 

NOTE: Because INP clears the receive comms 
buffer to remove spurious data when it is 
invoked, it is important to ensure that the 
HUNTER is ready to receive before the 
transmitting device begins to SEND. 
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3.4.3.11 COMMAND : 

EXPLANATION : 

EXAMPLES : 

REMARKS : 


KEYS 


KEYS 


Operation of the 'KEYS' function displays the 
alternate function key display line. Further 
operation of the function key will return HUNTER 
back to the original display line. 


SET 1: 

DIR STAT BAS COMS CLCK TERM EDIT KEYS 
SET 2: 

DIR STAT INP SAVE TYPE REN SEND KEYS 


DIR and STAT are the most commonly used keys and 
appear in both sets at easily accessible 
locations. 

DIR - Directory 

STAT - File status 

BAS - Basic interpreter 

COMS - Communications parameters 

CLCK - Set clock 

TERM - Terminal emulation 

EDIT - Text Editor 

INP - Load a file 

SAVE - Create a file from memory 

TYPE - Display an ASCII file 

REN - Rename a file 

SEND - Transmit files 

For further information on soft keys, see 
section 4.5.4.1, SOFT KEYS. 
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LOAD 


3.4.3.12 COMMAND : LOAD filename 


EXPLANATION : The file is loaded into RAM page 0 ready for 
execution (EXECUTE) or dumping through the 
serial port in Hex format (SEND). 


EXAMPLES : >LOAD PROG1.COM 

The program PROG1.COM is loaded into the 
execution memory. 


REMARKS : Files are loaded into location 100H upwards. 

Normally, this facility will be used to dump the 
file in Intel Hex format. 
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REN 


3.4.3.13 COMMAND : REN filename 1=filename2 

EXPLANATION : Rename the filename2 to filenamel 

EXAMPLES : >REN NEW.NAM=OLD.NAM 

This will rename the file OLD.NAM to NEW.NAM . 

REMARKS : Care should be exercised when renaming files 
to prevent duplicate file names existing. 
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SAVE 


3.4.3.1 1 ! 


COMMAND : SAVE n filename 

EXPLANATION : Create a file from current memory. 


EXAMPLE : >SAVE 128 BIGFILE.COM 

This will create a file 32k bytes in length. 

REMARKS : A program currently residing from 100H in RAM 
page 0 is transferred to the specified file. 
The number of 256 byte blocks also has to be 
specified. 

Calculate the number of blocks ’n' as follows: 


1 

block = 

256 bytes 

1 

K bytes = 

4 

blocks 

2 

K bytes = 

8 

blocks 

8 

K bytes = 

32 

blocks 

16 K bytes = 

64 

blocks etc., 


The maximum program size is 54K. 

See 'LOAD' in Part 5, BASIC FUNCTIONS. 
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SEND 


3.4.3.15 COMMAND : SEND filename [A] 


EXPLANATION : Outputs files via the serial port. 


EXAMPLES : To output a file in 8-bit format: 

>SEND DEMO.COM 

To output an ASCII file to, say, a printer: 

>SEND LETTER.TXT A 

To output in Intel Hex format, first LOAD the 
file into the execution RAM page 0, then type: 

SEND n 

n is the number of 256 byte blocks required to 
be sent. 


REMARKS : To transmit in 8-bit format, remember to set the 
communication parameters correctly i.e. Parity 
to 8-bit and SERIG to off. 

Transmission can be aborted with the 'ESC' key. 

The only real difference between 8-bit format 
and ASCII dumping is that transmissions cease on 
the first occurence of the end of file character 
'control V (1A Hex) in the file. 

NOTE: If transmitting, using 8-bit data format, 
a .COM or a HUNTER.HBA file, the LF option in 
the communications menu MUST be turned off to 
prevent the insertion of LF characters following 
CR characters, possibly corrupting the object 
code file being received. 

NOTE: SEND cannot transmit a file whose name 
begins with a numeric character and will return 
a Syntax error. Rename the file using REN 
first, or use Hex format. 


VER.V09F 


PAGE 3 - 27 



FILE. MANAGER 


SECTION 3.4 


STAT 


3.4.3.16 COMMAND : STAT [filename] 


EXPLANATION : Extended file directory display. 


EXAMPLES : >STAT FIRSTFIL.COM 

The following will be displayed: 


Rees Bytes Ext. ACC 
64 16K 1 R/W :FIRSTFIL.COM 

24K bytes available 


Rees = Number of 128 byte blocks. 

Bytes = Size of file in 'K' bytes. 

Ext = Number of 16K extension blocks. 

Acc = Access to file R/W - Read Write R/0 - 
Read Only. 


REMARKS : STAT may also be used with wildcards. 

>STAT *.HBA 

Will display the status of all HUNTER Basic 
files stored in memory. 
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TERM 


3.4.3.18 COMMAND : TERM 

EXPLANATION : HUNTER emulates a CRT terminal. 

EXAMPLES : >TERM 

REHARKS : In terminal emulation mode, HUNTER can be used 
as: 

1) A remote dialup terminal. 

2) A peripheral to other computer systems. 

3) A portable 'Telex’. 


See section 6.8, TERMINAL EMULATION, for further 
information. 

Two function keys are implemented in TERM: 

Function 2 - COM MS set up 
Function 8 - Exit to system 

The type of terminal to be emulated is 
determined by the setting of the communication 
parameters. See section 6.4.1. 

NOTE: Automatic power down does not operate in 
Terminal Emulation. This prevents inadvertant 
dropping of communications lines. 

TERM may be used from user programs (see section 

6 . 8 . 8 ). 
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TYPE 


3.4.3.19 COMMAND : TYPE filename 


EXPLANATION : List ASCII file to HUNTER’S screen. 


EXAMPLES : >TYPE FILE.TXT 

This will output the filename FILE.TXT to the 
screen. 

REMARKS : Scrolling may be halted with 'control S' and 
restored with any other key. Any character 
typed while the screen is scrolling, besides 
'control S' will abort the display. 

Typing non-ASCII files may give confusing 
results. 
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CP/M INTERFACE 


3.5 CP/M provides a universal interface linking application programs 

into the operating system. Through a system of calls to one 
location (0005 Hex) with the CPU register C set to the call 
number, the ROM-based operating system in HUNTER will implement 
the function and return to the user program. HUNTER is there¬ 
fore compatible with many readily available commercial products, 
conforming to these standard system calls. 

3.5.1 SYSTEM CALLS 

CP/M system calls fall into two distinct categories. They are 
console (e.g. keyboard/LCD display) I/O and file I/O. Files are 
organised as CP/M disk files and may be accessed through a file 
control block (FCB). 

TABLE 3.2 SYSTEM CALLS 


0 System Reset 

19 

Delete File 

1 Console Input 

20 

Read Sequential 

2 Console Output 

21 

Write Sequential 

3 Reader Input 

22 

Make File 

4 Punch Output 

23 

Rename File 

5 List Output 

- 24 

Return Login Vector 

6 Direct Console I/O 

25 

Return Current Disk 

7 Get I/O Byte 

26 

Set DMA Address 

8 Set I/O Byte 

27 

Get Addr(Alloc) 

9 Print String 

28 

Write Protect Disk 

10 Read Console Buffer 

29 

Get R/0 Vector 

11 Get Console status 

30 

Set File Attributes 

12 Return Version Number 

31 

Get Addr(Disk Parms) 

13 Reset Disk System 

32 

Set /Get User Code 

14 Select Disk 

33 

Read Random 

15 Open File 

34 

Write Random 

16 Close File 

35 

Compute File Size 

17 Search for First 

36 

Set Random Record 

18 Search for Next 

37 

Reset Drive 


System calls 38-47 refer to HUNTER operating system only. 


CP/M is a registered trademark of Digital Research Corp. 
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3.5.2 FILE CONTROL BLOCK 

The FCB contains 36 bytes of information on the current file 
being accessed. On HUNTER, the default FCB location is at 
005CH, containing the following information:- 


TABLE 3.3 FCB DESCRIPTION. 


Byte Description 

1 Drive code (zero) 

2-9 Eight Character ASCII filename 

10-12 ASCII file extension 

13 Current extent number 

14-15 Reserved 

16 Record count for extent 

17-32 Reserved for system use 

33 Current record in sequential file operation 

34-36 Random record number 


3.5.3 HUNTER SYSTEM CALLS 

This manual does not contain an exhaustive description of each 
system call, since they are defined and explained in great depth 
in many other publications. However, there does follow a brief 
description of each call, together with details of extra calls 
specific to HUNTER. 

The C register is loaded with the call number plus any other 
parameters into other registers, and the A call is made to 
address 0005. Registers not mentioned are irrelevant on entry, 
and none are necessarily preserved on exit. For making these 
calls from Basic, see the CALL and ARG in Part 5, BASIC 
FUNCTIONS and section 4.8, MACHINE CODE CALLS. 
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3.5.3.1 

FUNCTION 


System Reset 


CALL NO. 


0 {ie Register C = 0 } 


ENTRY 


None 


EXIT 


None 


REMARKS 


A system restart, re-entering HUNTER'S operating 
system. 

3.5.3.2 

FUNCTION 


Console Input 


CALL NO. 


1 


ENTRY 


None 


EXIT 


ArASCII character. 


REMARKS 


Read keyboard and echo onto screen. The call will 
wait until a key is pressed. 

3.5.3.3 

FUNCTION 


Console Output 


CALL NO. 


2 


ENTRY 


E=ASCII character. 


EXIT 


None 


REMARKS 


The character is displayed on the screen at the 
location of the cursor. 


3.5.3.4 FUNCTION : 

Reader Input 

CALL NO. : 

3 

ENTRY : 

None 

EXIT : 

A=ASCII character. 

REMARKS : 

The next character is read from the serial I/O 
buffer. 


3.5.3.5 

FUNCTION : 

Punch Output 


CALL NO. : 

4 


ENTRY : 

E=ASCII character. 


EXIT : 

None 


REMARKS : 

The character is sent out through the serial port. 

3.5.3.6 

FUNCTION : 

List Output 


CALL NO. : 

5 


ENTRY : 

E=ASCII character. 


EXIT : 

None 


REMARKS : 

As call 4. 
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3.5.3.7 FUNCTION : Direct Console I/O 
CALL NO. : 6 

ENTRY : E=0FFH for input, E=ASCII character for output. 

EXIT : A=ASCII character if input, A=status if output. 

REMARKS : Similar to calls 1 and 2, but there is no automa 

echo to the screen. If a character is not ready 
from the keyboard then A=00 on return. 


3.5.3.8 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Get I/O Byte 

7 

None 

A=1/0 status. 

The present I/O status byte is returned. 


3.5.3.9 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Set 1/0 Byte 

8 

E=I/0 value. 
None 

I/O byte is set. 


3.5.3.10 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Print String to Console 
9 

DE=string address. 

None 

An ASCII string whose start address is loaded into 
DE, is displayed on the screen. The string must be 
terminated with "$". 


3.5.3.11 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Read Console Buffer 
10 

DE=buffer address. 

None 

The keyboard is read and the characters are placed 
into a buffer, the start address having been loaded 
into DE. The first byte contains the maximum 
number of characters to read into the buffer, the 
second byte contains the number of characters that 
have been placed into the buffer when input has 
been terminated with C/R or L/F. See section 9.15, 
read console buffer, for further information. 
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3.5.3.12 FONCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Get Console Status 
11 

None 

A=console status. 

If a character has been typed in then 01H is 
returned, 00H if not. 


3.5.3.13 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Return Version Number 
12 

None 

HL=version number. 

HUNTER is CP/M version 2.2 compatible, so 0022H is 
returned. 


3.5.3.14 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Reset Disk System 

13 

None 

None 

The filing system is reset, and the DMA address is 
returned to 80H. 


3.5.3.15 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Select Disk 
14 

None 

None 

HUNTER has "RAM disks" so this call produces no 
action. 


3.5.3.16 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Open File 
15 

DE=FCE address. 

A=directory code 

The file specified by the FOB is opened. If 
successful A=0,1,2 or 3. If not, then A=0FFH. 


3.5.3.17 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Close File 
16 

DE=FCB address. 

A=directory code. 

If successfully closed, A=0,1,2 or 3, otherwise 
A=0FFH. 
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3.5.3.18 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Search for First 
17 

DE=FCB address. 

A=directory code. 

The directory is searched for the first match of 
the FCB. A=0FFH if there is no match, and 0,1,2 or 
3 if there is. The filename is returned into the 
current DMA buffer. The search function returns 
the complete entry from the buffer. 


3.5.3.19 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Search for Next 
18 

None 

A=directory code. 

Similar to CALL 17, except that the next entry is 
looked for. The search function returns the 
complete entry from the buffer. 


3.5.3.20 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Delete file 
19 

DE=FCB address. 

A=directory code. 

Files which match the FCB are deleted. If none 
exist A=0FFH is returned. 


3.5.3.21 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Read Sequential 
20 

DE=FCB address. 

A=directory code. 

The specified file is read, and the sector copied 
to the current DMA address. A = 00 for a successful 
read. 


3.5.3.22 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Write Sequential 
21 

DE=FCB address. 

A=directory code. 

The record at the current DMA address is written to 
the disk. A=00 to indicate a successful write. 


3.5.3.23 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Make File 
22 

DE=FCB address. 

A=directory code. 

The specified file is created. A=0-3 if successful, 
or A=0FFH if not. 
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3.5.3.24 


3.5.3.25 


3.5.3.26 


3.5.3.27 


3.5.3.28 


3.5.3.29 


3.5.3.30 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Rename a File 
23 

DE=FCB address. 

A=directory code. 

The file specified in the first 16 bytes of the FCB 
is renamed to that name in the second 16 bytes. 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Return Login Vector 
24 

None 

HL=login vector. 

HUNTER returns HL=1 and A=1, indicating a single 
disk system. 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Return Current Disk 

25 

None 

A=current disk. 

Zero is always returned on HUNTER. 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Set DMA Address 
26 

DE=DMA address. 

None 

The current disk data buffer area is set to DE. 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Get Allocation Address 

27 

None 

HL=allocation address. 
Zero only is returned. 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Write Protect Disk 
28 


Returns with no effect. 


FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


Get Read Only Vector 
29 


Returns with no effect. 


VER.V09F 


PAGE 3-38 









FILE MANAGER 


SECTION 3.5 


3.5.3.31 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


3.5.3.32 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


3.5.3.33 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


3.5.3.34 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


3.5.3.35 FUNCTION 
CALL NO. 
ENTRY 
EXIT 
REMARKS 


3.5.3.36 FUNCTION 
CALL NO. 
ENTRY 
EXIT 

REMARKS 


Set File Attributes 
30 

DE=FCB address. 

A=directory code. 

File attributes for read only etc. are set or reset 
as specified. 


Get Disk Parameter Address 
31 

None 

HL=disk parameter block address 

Disk parameters are returned which indicate a 
double sided double density disk. This is to allow 
for expansion within HUNTER. It should not be used 
for space calculation purposes. 


Get or Set User Code 
32 


Returns with no effect. 


Read Random 
33 

DE=FCB address 
A=directory code. 

: The file is read at the specified record. Normally 
non zero directory codes mean an error. 


Write Random 
34 

DE=FCB address. 

A=directory code. 

The file is written at the specified record. A=0 
means a successful write. 


Compute File Size 
35 

DE=FCB address 

: Random record field set to one plus the last 
record. 
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3.5.3.37 FUNCTION : Set Random Record 
CALL NO. : 36 

ENTRY : DE=FCB address. 

EXIT : Random record field set. 
REMARKS : 


3.5.3.38 FUNCTION : Reset Drive 
CALL NO. : 37 

ENTRY : DE=drive vector. 

EXIT : None 

REMARKS : HUNTER's filing system is reset. 


3.5.3.39 FUNCTION : Set up the RS-232 Serial Port 

CALL NO. : 38 

ENTRY : None 

EXIT : None 

REMARKS : The software setup routine is entered to set up the 

serial communications. 


3.5.3.40 FUNCTION : Initialise the Clock 

CALL NO. : 39 

ENTRY : None 

EXIT : None 

REMARKS : The time and date buffer RAM is copied to the 

clock. 


3.5.3.41 FUNCTION : Write Random with zero fill 
CALL NO. : 40 

ENTRY : DE=FCB address 

EXIT : A = directory code 

REMARKS : The write random with zero fill operations is 

similar to function 34, with the exception that a 
previously unallocated block is filled with zeros 
before data is written. 

NOTE: on early HUNTERs, this call was used for a 
different function. 

3.5.3.42 FUNCTION 
CALL NO. 

ENTRY 
EXIT 
REMARKS 


Initialise communications 
41 

None 

None 

This call allows configuration of the 
communications exactly as the standard HUNTER 
initialise communications routine. 
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3.5.3.43 FUNCTION 

: Serial Status 

CALL NO. 

: 42 

ENTRY 

: None 

EXIT 

: A = port status 

REMARKS 

: To test for pending serial input characters A=0 for 
no characters read else A is non-zero 


5.3.44 FUNCTION 

: Terminal emulation call 

CALL NO. 

: 43 

ENTRY 

: None 

EXIT 

: None 

REMARKS 

: Enters terminal emulation mode 


3.5.3.45 

FUNCTION 

Wand input call 


CALL NO. 

44 


ENTRY 

DE=Buffer Address 


EXIT 

None 


REMARKS 

The Wand code is selected previously by setting the 
bartype location according to wand code being read. 



The code is read into the buffer. The user must 
provide the buffer address and, in the first 
location of the buffer, the user must provide the 
maximum number of characters to be read into the 
buffer. On exit, the second byte of the buffer 
contains the number of characters that have been 
placed in the buffer, followed by the wand 
character's input. 

3.5.3.46 

FUNCTION 

Fetch key without echo 


CALL NO. 

47 


ENTRY 

None 


EXIT 

REMARKS 

A = ASC code of character 

3.5.3.47 

FUNCTION 

Read the Clock 


CALL NO. 

48 


ENTRY 

None 


EXIT 

None 


REMARKS 

The time and date is copied from the clock into the 
time and date buffer RAM (see section 9.7), 
locations TENTHSEC to TENYR. 
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LOADING FILES 


3.6 The most important facility of a portable computer is its 

ability to communicate with other computers and peripheral 
devices. HUNTER has an industry standard RS-232 interface, 
supporting the most common and some of the not so common 
protocols and baud rates. See Part 6, COMMUNICATIONS. 

HUNTER is supported by a wide range of micro computer systems 
including the IBM-PC, Superbrain, Apple (with Z80 card) and ACT- 
Sirius. Sections 3.6.4 and 3.6.5, give a detailed description 
of how to connect the Apple and IBM-PC micro computers to HUNTER 
and transfer files. 

This section describes how to load a program file, an overlay 
file and an ASCII text file. 

Two methods of loading files are described. The first involves 
loading direct into a file in the 8-bit format. Files are sent 
out from the host computer as they exist on disk, but, for 
example, if the PIP utility is used it must have the [ 0 ] 
option to indicate that all 8 bits must be sent. The second 
method is more time consuming, but has the advantage of built in 
checksums to guarantee the accuracy of data. All files, 
including ASCII data files, must be converted into Intel Hex 
format, see section 9.10, HEX DATA FORMAT. These new files may 
be PIPed out to HUNTER in the normal manner. Both methods are 
described in full detail in the following subsections. The 
examples are particular to a CP/M machine. 

NOTE: Some CP/M systems may not be configured for 8 bit 
communication. Check the serial port hardware manual for 
details of the UART configuration if in doubt. 


Apple is a registered trademark of Apple Computer Inc. 
IBM-PC is a registered trademark of IBM Corp. 
Superbrain is a registered trademark of Intertec.. 
ACT-Sirius is a registered trademark of ACT. 
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.6.1 FILE DESCRIPTION 


File Name 

Type 

Length(k) 

No.blocks No.records 
(4xlength) (8xlength) 

MAIN.COM 

Object 

22k 

88 

176 

OVERLAY.OVR 

Object 

10k 

40 

80 

PRODUCTS.TXT 

ASCII 

14k 

56 

112 


The program MAIN.COM is a fictional file which organises and 
sorts a database file PRODUCTS.TXT . The file OVERLAY.OVR is an 
overlay file which like MAIN.COM is an executable program, but 
parts are loaded into the execution RAM page as and when 
required by MAIN.COM. All three files must be present in the 
filespace for correct operation. 


3.6.2 LOADING METHOD 1: 8-BIT DATA 

Step 1 Set up the communications, see Part 6, COMMUNICATIONS. 

Baud rate : As required. 

Protocols : None. 

Parity : 8-bit. 

RTS : As required. 

SERIG : Off. 

Step 2 Determine the size of the files to be copied. 

A>STAT *.* 


Rees 

Bytes 

Ext 

Acc 


176 

22k 

2 

R/W 

ArMAIN.COM 

80 

10k 

1 

R/W 

A:OVERLAY.OVR 

112 

14k 

1 

R/W 

A:PRODUCTS.TXT 


HUNTER loads files in blocks which are each twice the 
size of Records. Therefore MAIN.COM is 88 blocks in 
length. 

Step 3 Load MAIN.COM 

Connect up HUNTER to the host computer with a suitable 5 
way RS-232 cable. Then on HUNTER type: 

>INP 88 MAIN.COM 


VER.V09F 


PAGE 3-43 



FILE MANAGER 


SECTION 3.6 


After typing ENTER, HUNTER will respond with 

* Waiting 

To abort use the ESC key. If PIP is to be used to 
transfer the file to HUNTER using the LST: printer 
port, then type on the host computer 

PIP LST:=MAIN.COM [0 ] 

The [ 0 ] suffix is very important because this tells PIP 
to list using the full 8 bits. HUNTER will respond to the 
beginning of transmission with the message 

* Loading 

If too many blocks have been specified in the INP command 
then after transmission has completed the 'waiting' 
message will again be displayed. In this case use the ESC 
key to complete the transference of the file. 

The file MAIN.COM will now reside in a HUNTER file. 

Step A Load OVRERLAY.OVR 

The sequence of commands for loading this file is as 
follows: 

HUNTER >INP AO OVERLAY.OVR 

Host PIP LST: =OVERLAY.0VR[0] 

Step 5 Load PRODUCTS.TXT 

This file is loaded with these commands: 

HUNTER >INP 56 PRODUCTS.TXT 

Host PIP LST:=PR0DUCTS,0VR[0] 

Step 6 Run the program 

The three files MAIN.COM, MAIN.OVR and PRODUCTS.TXT 
should all now be in HUNTER files. Check this with the 
DIR command. Execute the CP/M program with 

>MAIN 

NOTE: Some CP/M machines may not be capable of 
transmitting 8 bits per byte. 
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3.6.3 LOADING METHOD 2: INTEL HEX DATA FORMAT 


Step 1 All files must be converted into Intel Hex data format. 
This is achieved with a standard CP/M utility program 
(usually called UNLOAD) a version of which is reproduced 
in section 9.5.4, PROGRAM 4 'UNLOAD'. 

When converted you will have two copies of each file, one 
in Intel Hex format: 


MAIN.COM 
OVERLAY.OVR 
PRODUCTS.TXT 


MAIN.HEX 
OVERLAY.HEX 
PRODUCTS.HEX 


Step 2 Set up the communications, see Part 6, COMMUNICATIONS. 


Baud rate 

Protocol 

Parity 

RTS 

SERIG 


: As required 
: NONE 

: As required 
: As required 
: OFF 


Step 3 Load MAIN.COM 

Connect up HUNTER to the host computer with a suitable 5 
way RS-232 cable. Then on HUNTER type: 

>INP 

After typing ENTER, HUNTER responds with 

* Waiting 

To abort use the ESC key. If PIP is to be used to 
transfer the file to HUNTER using the LST: printer 
port, then type on the host computer 

PIP LST:=MAIN.HEX 

As soon as transmission begins, HUNTER responds with 

* Loading 
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The file is loaded not directly into a file, but to RAM 
page 0, the program execution page. When the file is 
loaded and HUNTER displays 

* Loading completed 
File length = 88 Blocks 

the data is written into a file with the SAVE command. In 
this case. 

>SAVE 88 MAIN.COM 

The file MAIN.COM is now created. 

Step 4 Load 0VERLAY.0VR 

The sequence of commands for loading this file is as 
follows: 

HUNTER >INP 

Host PIP LST: =0VERLAY.HEX 

HUNTER >SAVE 40 0VERLAY.0VR 

Step 5 Load PRODUCTS.TXT 

This file is loaded with these commands: 

HUNTER >INP 

Host PIP LST:=PRODUCTS.HEX 

HUNTER >SAVE 66 PRODUCTS.TXT 


Step 6 Run the program 

The three files MAIN.COM, MATN.OVR and PRODUCTS.TXT 
should all now be in HUNTER files. Check this with the 
DIR command. Execute the CP/M program with 

>MAIN 
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NOTE: This method of loading HUNTER is again suitable for 
all types of files, but compared with 8-bit loading is 
two and a half times slower. However it does have the 
advantage that if an error occures during transmission 
then the hex checksum will detect this and 

* Loading error 

will be displayed. 


3.6.4 HUNTER TO APPLE INTERFACE 

An Apple He micro computer fitted with a Z80 card and running 
the CP/M operating system can communicate with HUNTER via the 
RS-232 communications port. 

When the HUNTER is downloading to the Apple, problems may arise 
if the file being transferred is larger than 16K. This is 
because the Apple does not prevent incoming data during a disk 
access, and therefore may well loose characters. It is 
advisable to arrange for data within the HUNTER to be stored in 
15K files and then transmit each file separately. 

3.6.4.1 Apple Serial Card 

A standard Apple compatible serial interface card, preferred 
type CCS7710A, must be installed in slot 2 of the Apple with its 
25 pin *D 1 connector mounted on the rear panel in position 7. 

3.6.4.2 Interface Cable 

The interface cable required to connect HUNTER to an Apple micro 
computer fitted with the above serial card should be fitted with 
a female 25 pin 'D' connector at one end, HUNTER, and a male 25 
pin 'D' connector at the other, Apple. Pins 2,3,4,5 and 7 should 
be connected with a jumper connection from pin 8 to pin 20 on 
the male connector, Apple, see Fig 3.4, HUNTER TO APPLE CABLE. 


VER.V09F 


PAGE 3-47 



FILE MANAGER 


SECTION 3.6 


Fig 3.4 HUNTER TO APPLE CABLE 
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3.6.^.3 Apple Baud Rates 

The baud rate on the Apple is selected by setting the 4-way DIP 
switch located at the top right hand corner of the above serial 
interface card, the switch should be set to 4800 baud, see Fig 
3.5, APPLE BAUD RATE SELECTION, for switch setting's. 
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Fig 3.5 APPLE BAUD RATE SELECTION 



3. 6 . 4,4 HUNTER Baud Rate and Protocols 


HUNTER'S communication parameters should be set as follows: 


Transmit 

Rate-4800 

Prtcl-N. 

Prty-N 

CTS-Y 

DTR-N 

LF-Y 

Echo-Y 

Null-0 


Receive. 

Rate-4800 

Prtci-N 

Prty-N 

RTS-HOLD 

DSR-N 

DCD-N 

Serig-off 
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See section 6.4, COMMUNICATIONS PORT SOFTWARE, for further 
details of selecting and setting HUNTER'S communication 
protocols. 
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3.6.4.5 Basic Program Transfer 

When the correct communication protocols have been set and the 
interface cable installed, program transfer can take place. 
HUNTER will be treated as RDR: for input and PUN: for output. 
HUNTER should be in Basic interpreter mode, select 'BAS' from 
the File Manager function keys, with the program resident in 
RAM page 0, for Basic text transfers. For file or CP/M program 
transfers, refer to the examples given earlier. 

HUNTER to Apple 

To transfer a program from HUNTER to the Apple proceed as 
follows: 

1) Apple >PIP A: filename=RDR: 

2) HUNTER LLIST 

3) When transmission is complete type L0PCHR26 (control Z) on 
HUNTER. 

4) Apple will now have a copy of the program stored on disk with 
the specified filename. 

NOTE: If the program is greater then 20k the Apple may store 
part of the file to make more memory available for the incoming 
program. 

Files created on the Apple in this way can be handled with the 
usual CP/M utilities such as 'ED' or more sophisticated programs 
such as word processors etc. 

Apple to HUNTER 

To transfer a program from an Apple disk file to HUNTER proceed 
as follows: 

1) Clear HUNTER'S memory with ’NEW 1 2 3 4 . 

2) HUNTER LL.OAD 

3) Apple >PIP PUN:=A:filename [E] 

4) When transmission is complete switch HUNTER off and back on 
again, the program may now be run. 

3.6.5 Hunter to IBM-PC Interface 

An IBM PC or XT computer, fitted with the asynchronous 
communications adaptor can communicate with the HUNTER to either 
load or unload programs and data. 
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A package consisting of cable and floppy disk with 
communications software is available from Husky Computers 
Limited, 

Order as 'IBM-PC Communications Package'. 

3.6.5.1 IBM-PC Conmunications Adaptor 

The asynchronous communications adaptor for the IBM machine is 
the standard part number 1502074. It is available from all IBM- 
PC dealers and arrives complete with installation instructions 
for RS-232. 

3. 6 . 5.2 Interface Cable 

The interface cable required to connect HUNTER to the IBM-PC, 
fitted with the above serial card, is a special one to ensure 
correct operation. The two female 25-pin 'D* type plugs are 
connected as below: 



3.6.5.3 Conmunications Software 
a) The HUNTER 

No special software is required on the HUNTER. However, 
knowledge of the following commands will be necessary for 
communications. 
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From the filemanager: 

(i) INP 

(ii) SEND 

and the following HUNTER BASIC commands/statements: 

(i) LLOAD 

(ii) LUST 

(iii) L,INPUT 

(iv) LPRINT 

(v) LINCHR 

(vi) LOPCHR 

See also the section on Communications, Section 6, with 
particular attention to comms parameter setup. 

b) The IBM-PC 

Special software is required for full communication capabilities 
on the IBM-PC. This software, together with the interface 
cable, is available from Husky Computers Limited on an IBM disk. 


3. 6 . 5 . 4 HUNTER Communications Set-up 

To communicate in both directions at 4800 baud, the 
communication parameters should be set as follows: 


TRANSMIT 

RECEIVE 

Rate 

_ 

4800 

Rate - 4800 

Prtcl 

- 

None 

Prtcl - None 

Prty 

« 

8-bit. 

Prty - 8-bit 

CTS 

- 

y 

RTS - hold 

DTR 

- 

n 

DSR - n 

ECHO 

- 

n 

DCP - n 

LF 

- 

n 

Serig - Off 

Null 

- 

0 

T/0 - no 

T/0 

- 

no 



The above setup allows full bi-directional communications with 
hardware handshaking. Both ASCII text files and 8-bit object 
code files can be up and down loaded. 
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3.6.G.5 IBM-PC Communications Program 

The files supplied on disk are: 

C0MMS1.BAS 

BASTC.COM 

HUNTCOM.BAT 

To run the program, follow these steps: 

a) Turn on the IBM-PC 

b) Insert a 'DOS' disk into the A drive 

c) Insert the supplied disk into the B drive 

d) Copy the files onto the A disk: 

copy B:*.* A: 

e) Remove the B disk and store in a safe place 

f) Type: 

huntcom 

g) The IBM comms program is now running and asking for your 
selection of baud rate. 

It displays: 

Asynchronous Communications Program 
select baud rate ('s' for system): 

(1) 300 

(2) 1200 

( 3 ) 4800 

3.6.5.6 Loading files from the IEM-PC 

Make sure the file you want to send is on one of the disks in 
the IBM-PC and also that the three communications files are on 
the disk in the A slot. 

a) Plug the cable into the HUNTER and into the asynchronous 
port. 

b) Switch on the HUNTER and enter the file manager. 

c) Set up the HUNTER comms parameters. 

d) On the HUNTER, type: 

INP no.blocks filename 
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c) Set up the HUNTER comnris parameters as before. 

d) On the IBM, select baud rate. 

i.e. type '3' for 4800 baud. 

e) When prompted with: 

(R)eceive or (T)ransmit _ 

type 'r f for receive. The following message will then 
appear on the bottom line. 

'any key to abort' 

f) Enter Basic on the HUNTER with the Basic file loaded into 
the workspace. On the HUNTER type: 

LLIST 

This will list the Basic program to the IBM for storage in 
the selected file. 

g) Transmission is over when the HUNTF.R displays: 

READY 

h) Hit any key on the IBM to close its file. 

An ASCII file with Basic Text may be transferred directly into 
the Basic workspace using the LLOAD command in Basic. This is 
done as follows: 

a) Plug the cable into the HUNTER and into the asynchronous 
port. 

b) Switch on the HUNTER and enter the file manager. 

c) Set up the HUNTER comms parameters. 

d) On the HUNTER enter Basic and type: 

L.LOAD 

e) On the IBM-PC, select the baud rate: 

i.e. type '3' for 4800 baud 

f) You are now prompted with: 

(R)receive or (T)ransmit _ 

Type 't' for transmit. 
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g) Enter the filename of the file you wish to transfer. It may 
be preceded with a drive name if required: 

e.g. b:filename 

h) The bottom line of the display should show: 

transmitting 

to indicate that transmission is taking place. 
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MEMORY MAPS 


3.7 This section describes the operating system RAM at the top of 

page RO. Important locations are detailed, many of which the 
user may wish to use for advanced programming. Fig 3.6, RAM PAGE 
0, is an overall map of the system. A listing of memory 
locations may be found in section 9.7, MEMORY LOCATIONS. 


Fig 3-6 RAM PAGE 0 
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3.8.1 INTRODUCTION 

The automatic program continuation command 'CONT' provides the 
user with the facility to continue execution of a program after 
HUNTER has been switched off. Power off may have been caused by 
execution of the POWER OFF function in Basic, Auto power off or 
operation of the power off key. 


3.8.2 COMMAND SYNTAX 

The syntax of the 'CONT 1 command is as follows: 

>C0NT filename 

where 'filename' is the name of a file containing a Basic source 
program or a CP/M program. The three character file type 
extension does not have to be entered if it is a .COM file, but 
must be included for HUNTER Basic files. For example, if a Basic 
program file is called PR0G1.HBA, the following command would 
load and run the program via the Basic interpreter: 

>CONT PR0G1.HBA 

and the CP/M program PROGA.COM would be run if the following was 
entered: 

>C0NT PROGA 

If the filename does not have a .COM or .HBA extension, 'CONT' 
will default the file type extension to .COM, so if the filename 
PR0G2.TXT is entered 'CONT' will default the filename to 
PROG2.COM. If it does not exist a 'File not found' error will 
occur. 


3.8.3 PROGRAM CONTINUATION 

At any time during program execution HUNTER may be switched off 
by operation of the power key, automatic power off or any other 
means *. The next time HUNTER is switched on the program will 
continue execution from the point at which HUNTER was switched 
off. 


* See 3.8.5. 
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3.8.4 EXITING 'CONT' 

To escape from 'CONT' press (control C) and hold down, then 
power up. HUNTER will bleep twice and then wait for the escape 
code to be entered (default code 56580). Failure to enter the 
correct code will result in a bleep from HUNTER and continuation 
of the program. If the code is entered correctly then HUNTER 
will power down immediately. The next power up will revert to 
the operating system in the normal way. When continuing a .HBA 
file it is possible to escape from the program by pressing 'ESC* 
and entering the escape code.as above. 

3.8.5 POWER LOSS 

If power loss occurs by removing the batteries, the next power 
up will cause HUNTER to reload the file that was being run and 
execute the program from the start. 

Power loss can also be caused by excessive shock, battery 
failure, nuclear effects or other means. 
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3.9 DEMOS ERROR MESSAGES 

The following are operating system error messages which can occur in 
DEMOS: 

3.9.1 Syntax 


Due to:~ 

.a) Missing *=' between 2 filenames in REN 

b) Missing number of 128 byte blocks in SAVE 

c) Missing space between byte block number and name in SAVE 

d) Missing number of 128 byte blocks in INP 

e) Missing space between byte block number and name in INP 

f) Missing number of 256 byte blocks in SEND 

g) Missing CR immediately after the filename in SEND 

3.9.2 No File 


Due to:- 

a) Missing file name in EDIT 

b) The file does not exist in ERA 

c) The old file name does not exist in REN 

d) The Basic file does not exist when trying to load and run the 
file from DEMOS 

el No files in the HUNTER when enter STAT *.* 
f) .COM file does not exist when name is entered 

3.9.3 Bad Name 


Whenever an invalid file name format is specified. 
3.9.A Memory Overflow 


Due to:- 

a) The text equivalent of a basic tokenised file exceeding the 
available space in Ram page 0. 

b) Excess number of 128 byte blocks in SAVE 

c) Excess number of 256 byte blocks in SEND 
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3.9.5 Aborted 
Due to:- 

Pressing the ESC key when the HUNTER is executing TYPE or INP 

3.9.6 Disk Full 


At any time when trying to write to a file when there is no space 
remaining in the file space. 

3.9.7 Disk Error 


Due to a file having been corrupted, e.g. an incorrect checksum for 
the file. 
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INTRODUCTION 


4.1 HUNTER Basic is a powerful and flexible Basic interpreter 
installed within HUNTER'S firmware, allowing user programs to be 
easily written and used without the need for any additional 
equipment. In addition to normal programming features, HUNTER 
Basic can also handle communications with other devices. 

Because it's designed for use in the portable environment, 
HUNTER Basic has some unique features not found in other 
Basics. Principal among these is the ability of HUNTER Basic to 
keep both programs and data after its power has been switched 
off. Data can be used later by the same or another program 
following an intervening period when HUNTER is powered down and 
not in use at all. Similarly, user programs written in HUNTER 
Basic are retained and are always available for further use 
until deliberately cleared. 

Different programs can be stored simultaneously in program space 
or in files and executed independently. 

4.1.1 INITIATING HUNTER BASIC 

HUNTER Basic is accessed from the File Manager by typing BAS 
followed by the 'Enter' key or by pressing the appropriate 
function key if the HUNTER System Functions are displayed. When 
HUNTER's Basic Interpreter has been entered the- following screen 
is displayed: 


Hunter Basic Interpreter 
READY 


File Run Edit List Save Load Kill Syst 


To return to File Manager from Basic press 'SYST' function key 
or type 'SYSTEM' and press the 'Enter' key. 

Alternatively, a HUNTER Basic program (.HBA extension) may be 
executed directly from the File Manager by typing the file name 
followed by 'Enter'. In this case, the Basic Interpreter screen 
does not appear and the program executes immediately. For 
further details see section 3.2, PROGRAM EXECUTION. 
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4.1.2 BASIC PROGRAMS 

Program source code for execution by the resident Basic 
Interpreter can be provided by a variety of sources, including 
the following: 

1) HUNTER Basic (.HBA extension) files. 

2) Text (.TXT extension) files. 

3) Direct keyboard entry using Edit. 

4) Down line loading using LLOAD. 

Programs are entered into HUNTER'S execution memory by a 
sequence of line numbers and program statements. Unnumbered 
lines will execute immediately. Variables can always be 
inspected using "Print" statements. Effects of functions and 
other operators can be determined empirically by simply typing 
unnumbered lines and observing the result. 

Certain functions cannot be executed directly . - 
e.g. GO SUB 

NOTE: It ib recommended that NEW is typed before entering a 
program in order to remove any previous programs. 

4.1.3 AUTO START BASIC 

Provision has been made for Basic programs to execute 
immediately on power up. See section 4.12, AUTO POWER FEATURE. 

NOTE: A number of programs can be found in section 9.5, 
DEMONSTRATION PROGRAMS. 
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SYNTAX 


4.2 The functions described in this manual follow the conventions 

set out below. For all Basic statements and commands the syntax 
must be correct for the program to run successfully. 

1) Basic reserved words are printed in uppercase, but they may 
be entered into ,HUNTER as either uppercase or lowercase or a 
combination of both. Either way, the interpreter will 
convert them to uppercase. 

2) Items not in square brackets are essential arguments to the 
Basic function and must be included. 

3) Square brackets indicate that the item is optional. 

4) Punctuation must be included where shown. 

4.2.1 DESCRIPTION OF FUNCTIONS 

HUNTER Basic understands four kinds of function: 

Commands 

Statements 

Operators 

Functions 

Commands generally initiate an action and can also control 
execution of application programs. 

Statements form the structure of application programs and direct 
program flow. 

Operators are used to relate data and to test for specified 
conditions. 

Functions perform arithmetic or string computations. 

Some commands and statements will function without further 
information, others require an argument. An argument is either a 
value, an expression or another function. 

A complete list of functions is given in section 5.1, INDEX TO 
BASIC FUNCTIONS. 
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4,2.2 EXPRESSIONS AND OPERATORS 

TABLE 4,1 SYMBOLIC OPERATORS FOR USE WITH NUMERICAL VARIABLES. 


* 

* or ** 
/ 

( 

) 

= > 
=< 
< 

> 

<> 


Equality or assignment of values 
Addition 

Subtraction or negation of value 

Multiplication 

Powers 

Division 

Open parenthesis 

Closed parenthesis 

Equal to or greater than 

Equal to or less than 

Less than 

Greater than 

Not equal to 


TABLE 4.2 OPERATORS FOR USE WITH STRING VARIABLES 

= Equality or assignment of values 

<> Not equal to 

+ String addition or concatenation 
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TABLE 4.3 LOGICAL OPERATORS 

Logical operators perform logical or 
Boolean operations on numeric values: 



NOT 

logical complement 


AND 

conjunction 


OR 

disjunction 


XOR 

exclusive OR 


EQV 

equivalence 


IMP 

implication 

TABLE 4.4 TRUTH TABLES 

NOT 

X 

NOT X 


T 

F 


F 

T 

AND 

X 

Y . X AND Y - . 


T 

T T ■ - 


T 

F F 


F 

T F 


F 

F F 

OR 

X 

Y X OR Y 


T T T 

T F T 

FT T 

F F. F 
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TABLE 4.4 CONT. 


XOR X Y X XOR Y 


T T F 

T F T 

FT T 

F F F 


EQV X Y X EQV Y 


T T T 

T F F 

FT F 

F F T 


IMP X Y X IMP Y 


T T T 

T F F 

FT T 

F F T 


4.2.3 LOGICAL OPERATIONS 

Logical operators act upon the binary equivalents of decimal 
arguments, bit by bit, where the argument is a 16 bit signed 2's 
complement number i.e. in the range -32768 to +32767. For 
example: 

PRINT 10 AND 6 

will print 2, since: 

10 = 0000000000001010 
6 = 0000000000000110 

Performing the AND operation bit by bit, only one bit remains 
non zero. See the AND truth table in TABLE 4.4 TRUTH TABLES, for 
further details. 
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Logical operations may also be used by conditional statements, 
for example: 

IF A=B AND B=C THEN PRINT"ALL EQUAL" 

In this example the following occurs: 

1) The variables A,B are tested for equality. If they are equal 
then a true (-1) condition is returned, if not then a false (0) 
is returned. 

2) The variables B,C are tested for equality. The results are 
as in (1) above. 

3) The logical operation AND is then performed on the results of 
(1) and (2) above, which returns either a true (-1) or false (0) 
result. It is this final result upon which the IF statement 
performs its conditional test (true or false). Since 
conditional statements always produce a logical result it is 
possible in some circumstances to omit a relational operator, 
for example: 

IF AOO THEN PRINT"A IS NON ZERO" 
may be replaced with: 

IF A THEN PRINT"A IS NON ZERO" 
or 

IF A=5 THEN PRINT -1 ELSE PRINT 0 
may be replaced with: 

PRINT A=5 

since A and 5 are tested for equality and if they are equal the 
-1 (true) is printed otherwise 0 (false) is printed. 
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VARIABLES 


4.3 The Basic workspace execution memory is automatically 

partitioned by the interpreter according to the number of 
program lines entered by the user and the variable storage space 
required. If more than 54K RAM is required then data must be 
stored as files which use filespace in other pages of RAM. For 
further details see section 3.3.5, HUNTER MEMORY ORGANISATION. 
However arrays of numerals or strings may be dimensioned as 
normal, the filing operation being totally transparent to the 
user. 

4.3.1 LINE NUMBERS 

Line Numbers are in the range 0 to 65535. Each line can be up 
to 254 characters long, including the line number. Extra lines 
can be inserted in the text by simply typing in a new line 
number between the two lines of interest. In view of this, it 
is recommended that line numbers are separated by an increment 
of 10 for each new line. Line numbers are stored in binary form 
and occupy a constant space in memory regardless of the number 
chosen. Each line number requires 2 bytes of memory. 

4.3.2 VARIABLE STORAGE 

HUNTER variables can be stored as either single or double 
precision floating point numbers. All simple variables are 
single precision giving 6 digit accuracy. Variables are 
designated by one alphabetic character (A-Z) followed by an 
optional alphanumeric character (A-Z) (0-9), giving up to 962 
separate variables. 

NOTE: Simple variable names ON, TO, IF, LN, AS, OR and PI should 
be avoided as these are also reserved words. Use as variables 
can lead to execution errors. 

4.3.2.1 Numerical Arrays 

Additionally, variables may form a one-dimension array using 
"DIM". Variable arrays may optionally be designated double 
precision giving 14 digit accuracy but with an additional memory 
overhead. Single precision arrays are designated by a number in 
parentheses following the variable name. 

A1(19),Z(2),C(X),A(20*T),AD(10),AZ(62) 

There can be 962 separately indentified arrays of single 
precision. 

NOTE: The number in parentheses can be an expression. Each 
variable occupies 5 bytes of HUNTER'S user memory in arrays, 7 
bytes otherwise. 
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4.3.2.2 Double Precision 

Double Precision arrays are indentified by the symbol '!’ 
followed by a number or expression in parentheses. Double 
precision variables have 14 digit accuracy. 

e.g . A1!(19),Z!(Z),C!(X),AA!(23) 

These are a further 962 arrays. 

Each double precision element occupies 9 bytes of HUNTER memory. 

4.3.2.3 Default Values 

All numeric arrays default to 11 elements unless dimensioned 
with DIM statement. 

4.3.3 STRING STORAGE 

Single element string arrays are automatically assigned without 
a DIM statement. The default length is 20 characters. 

String names are defined exactly as variable names, with one 
alphabetic character (A-Z) and one optional alphanumeric 
character (A-Z,0-9) followed by the ’$' symbol giving a total of 
962 separately identified string variables. 

HUNTER supports strings of 8 bit characters including the full 
ASCII character set. 

The maximum length of any string is 254 characters, with a 
default size of 20 characters. 

DIM A1 $( 10,15) 

defines a string array of 11 elements, each of which can be up 
to 15 characters long. 

The maximum size of an array depends on the memory available. 
Examples of String variables are: 

A1$,Z$,C5$(22),H$(J),MM$(32) 

String variables can be initialised using LET, just assigned 
using =(equate), or READing from DATA statements. 
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The first element of a string array may be referenced with just 
the variable name, without the need for any number in 
parentheses. 

Example: 

A1$,Z$ Actually refer to the variables A1$(0),Z$(0) 

A single variable may therefore be defined as: 

ST$(0,10) and used as: 

ST$ 


4.3.4 MULTIPLE STATEMENTS 

HUNTER Basic supports multiple statements in a single program 
line. Statements are separated by a colon(:). 

Example: 

100 A=0:B=10:PRINT A,B:B=11 

The primary use of this feature is to reduce the program size. 
It may also make a program more legible. 

If a colon is used at the end of a line, END is assumed and 
program execution stops. 

The following statements cannot form part of a multiple 
statement: 

DATA 

WHILE 

WEND 

If REM is used in a multiple statement, it must be the last 
statement in the line. 
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EDITOR 


.4 An advanced Editor is available in Hunter for creating and 

modifying text/Basic files. It may also be used for modifying a 
"Loaded" Basic program. 

This may be accessed by typing EDIT as a direct Basic command, 
or using function key 3. 

Basic text may then be edited. To return to Basic, the editor 
is "Exited". This will re-process the text into the compressed 
form used by Basic. 

A file may also be saved from within the editor. 

For a full description of the facilities available within the 
Editor, see section 7. 
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KEYBOARD 


4.5.1 HUNTER computers are supplied with a standard QWERTY keyboard, 
see Fig 2.3, KEYBOARD LAYOUT. 


4.5.2 ELECTRICAL RE-DEFINITION 

Keyboard keys are each equated to the characters they represent 
by unique numerical codes, as listed in section 9.2, ASCII 
CHARACTER SET. These values are defined according to the 
American Standard Code for Information Interchange (ASCII). 

The value returned to Basic in, for instance, an INCUR statement 
is the numerical equivalent of the key pressed. 

The ASCII definitions of each key for the keyboard are contained 
in 116 consecutive RAM locations named KEYBIJF. The upper shift 
keys are defined in the first 56 locations, followed by the 56 
lower shift keys. These memory locations form a 'map' of the 
physical keyboard. On power up, the HUNTER automatically 
defines these locations to a standard configuration. However, 
the programmer has the option to be able to define special 
keyboard arrangements. 

The schematic of the keyboard, see section 9.6 KEYBOARD MEMORY 
MAP, shows the value in KEYBUF for each key. 

As an example, consider the key fourth from the left on the top 
row. If it was required to program this key to be $ in upper 
case and S in lower case, two Poke operations would be required. 

POKE (KEYBUF), 36 
POKE (KEYBUF + 56), 83 

It is important to note that on powering up HUNTER, the keyboard 
will revert to the standard version. The programmer should 
define the special keyboard requirements at an early stage in 
the program and ensure that the re-definition occurs each time 
the program is run. 

4.5.3 The codes used bv the special control keys are listed in section 

2.4. 
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4.5.4 FUNCTION KEYS 

There are eight programmable function keys. They may be used as 
a quick method of entering frequently used commands or 
functions, or as eight separate interrupt keys. 


4.5.4.1 Soft Keys 

On entering the Basic interpreter, the bottom line of the LCD 
displays the default values. These may be changed at any time 
with the KEY function as described in Part 5, BASIC FUNCTIONS. 
The screen only displays the first four characters, although the 
string may be up to fifteen characters long. 

The display of the soft keys is entirely optional, but they are 
always active no matter whether they are displayed or not. This 
feature is controlled with the KEY ON and KEY OFF commands. 

4.5.4.2 Interrupt Keys 

The soft keys may be used to provide interrupts into Basic 
programs. The relevant Basic statements are: 

ON KEY (n) GOSUB line No. 

KEY (n) ON 
KEY (n) OFF 
KEY (n) STOP 

The interrupts are tested at the beginning of every Basic 
statement. Once a particular key has been pressed and has 
interrupted, then it cannot interrupt again, although other keys 
can still cause an immediate interrupt. However, one interrupt 
on a particular key can be held pending while its interrupt 
routine is executing. Function keys are recognised by having 
BIT 7 set (BIT 7 of the ASCII code). When in INPUT these 
interrupt keys are not serviced and, hence, the INPUT statement 
receives these codes from the keyboard buffer and outputs the 
relevant character to the screen. 
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MEMORY ALLOCATION 


4. 6 . 1 PROGRAM LIMITS AND MEMORY USAGE 

1. Ranges 

Variables: +9.99999E+126 

String arrays: Up to 254 characters per 

string 

Line numbers: 0-65535 inclusive 

Program line length: Up to 254 characters 

including line number 

2. Precision 

Single precision variables have 6 digit resolution. 
Double precision variables have 14 digit resolution. 

3. Memory overhead 

Program lines require 4 bytes minimum, as follows: 

Line number: 2 bytes 

Line length: 1 byte 

Carriage return: 1 byte 

Also each reserved word, operator, variable name character, 
special character and constant character requires 1 byte. 
Maximum program size in present versions: 54K,Bytes (Page 0) 

4.6.2 DYNAMIC (RUN-TIME) MEMORY ALLOCATION 

1. Symbol Table 

Entries occupy: 7 Bytes each 

Maximum symbol table size: 16K Bytes 

2. Single Precision Array 

DIM A(X) occupies (X+1)*5+7 Bytes 

3. Double Precision Array 

DIM AI(X) occupies (X+1)*9+7 Bytes 

4. String Array Elements 

DIM A$ I 'X,N) occupies (X+1)*N+7 Bytes 

5. Array Size 

Maximum number of elements in an array is 16,383. 
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HUNTER'S GRAPHICS 


4.7.1 HUNTER supports a graphics display of 240 x 64 pixels. Each 
point can be set to either white or black with the appropriate 
statement. Entering graphics mode is via the SCREEN statement, 
but this may be unnecessary since most of the functions which 
operate in graphics mode will automatically invoke the graphics 
screen. 

The graphics statements in Basic are:- 

CHAR LOCATE 

CIRCLE POINT 

CLS PRESET 

LINE PSET 

SCREEN 1 enters graphics mode but also defaults the current 
character set to CHAR 0 and clears the display. 

The origin of the graphics screen is the top left hand corner, 
with the co-ordinates (0,0). So PSET(0,0) will set the corner 
pixel black. The origin for the LOCATE function, to determine 
the starting point for displaying ASCII characters, is (1,1) in 
the top left hand comer. 

Co-ordinates when specified are always absolute, ranging 0-239 
for x and 0-63 for y. If two pairs of co-ordinates are 
required, then the first pair may be defaulted to the last 
plotted position. 

The above functions can be made to draw characters or lines in 
either white on black or black on white. This is achieved by 
appending another parameter after the command. For example, to 
print inverse characters of medium size use:- 

CHAR 2,1 

The M' means inverse. 

A detailed description of the above graphics commands can be 
found in Part 5, BASIC FUNCTIONS. 

NOTE: Graphics mode on the HUNTER does not directly support the 
simple cursor manipulation codes, e.g: backspace, line feed, 
etc. The operating system generates the required cursor move¬ 
ments. 
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4.7.2 GRAPHICS DEMONSTRATIONS 


The following program will draw a number of circles across the 
screen and back again: 

10 SCREEN 1 

20 FOR K=1 TO 167 STEP 4 
30 CIRCLE (K+30,32),30 
40 NEXT K 
50 CLS 

60 FOR K=167 TO 1 STEP -4 
70 CIRCLE (K+30,32),15 
80 NEXT K 
90 CLS 
100 GOT020 


The 'LINE' command may also be used for drawing boxes as well as 
drawing lines. The command: 

10 LINE (100,40)-(200,20) 

will draw a line from the co-ordinates 100,40 to 200,20, the top 
left hand corner of the screen being 0,0. The following will 
draw a box with the bottom left hand comer at point 100,20 and 
the top right hand comer at 200,20: 

10 LINE (100,40)-(200,20),1,B 

if the second parameter is used then the first must also be 
specified. The box may be filled in by appending ’F' to the 
second parameter. 


The Graphic's cursor can be positioned to any point on the 
screen by using the 'LOCATE' command. Pixels are set by using 
'PSET' or cleared by 'PRESET'. The following example will 
produce a dotted line across the screen: 

10 SCREEN 1 

20 FOR X=0 TO 239 STEP 4 
30 PSET (X,30) 

40 NEXT X 
50 END 
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MACHINE CODE CALLS 


4.8 HUNTER is designed to be extremely versatile and flexible in its 

use. For some applications it is not possible to perform every 
function using pure Basic routines, usually for reasons of 
speed. It is possible to write machine code routines in these 
situations. 

Also covered in this section is some general guidelines in the 
control of HUNTER by means of PEEK and POKE to specified memory 
addresses. 

It should be emphasised that the use of features described here 
is not recommended for users unfamiliar with computing at 
machine code level. 

4.8.1 THE MACHINE CODE 

HUNTER uses the CMOS NSC-800 microprocessor, which provides an 
instruction set entirely compatible with the popular Z80 micro¬ 
processor. For that reason it is not proposed to go into detail 
about the facilities offered by machine code and users are 
referred to any of the standard books which cover the Z80. 

It is not recommended, however, that the stack pointer register 
(SP) is used in a fashion incompatible with supporting inter¬ 
rupts. Standard use in the form of subroutine CALLs, PUSHs and 
POPs, however, is supported. 

4.8.2 BASIC CALL 

To execute a machine code program the function:- 
CALL(addr) 

is used. This will pass control from Basic to the address. A 
machine code RET will return the user to Basic. 

4.8.3 PASSING SIM PLE PARAMETERS 

It is possible to pass information both from Basic to the 
'CALLed' program and return the information back to Basic. 

NSC-800 is a trademark of National Semiconductor Inc. 

Z-80 is a trademark of Zilog Corporation Inc. 
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To set up outgoing data the ARG reserved word is used, format as 
shown. The variable will be equated to the value in brackets. 

A = ARG(5) 

will cause the NSC800 internal registers C and E to be set up as 
follows 

C = 5 
E = 0 

The pair are set up as a 16 bit integer, hence:- 

ARG (10*256+30) 

causes 

C = 30 and:- 
E = 10 (decimal) 

when CALL is executed. 

These registers are used for compatibility with the CP/M style 
system call structure. 

To return data to Basic the program:- 

1000 X = CALL (addr) 

causes the value of variable X to take on the value contained in 
register A. 

4.8.4 PASSING MULTIPLE VARIABLES 

To pass more than one integer between a 'CALLed' program and 
Basic the machine code linkage stack is used. 

This is controlled in Basic by PUSH and POP. Tn the routine:- 

1000 PUSH X,Y 
1010 A = CALL (addr) 

1020 Y = POP(1) 

1030 X = P0P(1) 

The integer values of X and Y are first placed on the stack and 
made available to the called routine, and then removed by the 
POP instruction back into their own variables. 
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When CALL is executed the register pair HL is used as an address 
pointer to the bottom of the stack on which the variables are 
placed 

X HIGH 
X LOW 
Y HIGH 
HL->Y LOW 

In other words HL is addressing the low byte of the most 
recently PUSHed variable. To access others then HL is 
incremented. These values may either be used by the called 
routine or modified and used by Basic. It is not necessary to 
preserve the contents of HL. 

11.8.5 CONTROLLING HUNTER 


Section 9.7, MEMORY LOCATIONS and 9.8, PORT ALLOCATIONS, contain 
list’s of available addresses of HUNTER parameters and system 
call addresses. The parameters may be written or read by means 
of PEEK and POKE operations. System calls may be used for 
functions such as the CLOCK or communications parameters. 

4.8.6 AVAILABLE MEMORY 

By subtle use of the DEFSEG statement, to address the required 
page, many places in RAM can be used for machine code implants. 
However, the only place in common RAM available (whatever DEF 
SEG is set to) is the serial communications buffer. Since the 
communications are active continuously on receive, take care not 
to let programs be corrupted. 50 hex bytes are available for 
small user programs at decimal address 62981 (see section 9.7). 

4. 8.6.1 MACHINE CODE IN BASIC 

The recommended method of storing machine code from BASIC is to 
store it in a dummy string array, a method for which is outlined 
below. 

a) First calculate the length of the machine code and dimension a 
string array with the required number of single byte elements 
using the formula: 

D= (N/2)— 1 

where 

N=number of bytes needed for machine code. 

and 

Dmumber of single byte elements required in dimension. 
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To reserve TO bytes of memory, the required dimension is DIM 
MC$(4,1). 

NOTE: After dimensioning, all the bytes will be set to zero. 

b) The start address of the reserved memory must be found. This is 
done as follows: 

Assuming the array name is MC$, the statement AD=VARPTR(MC$)-1 
will return the address of the first reserved byte in AD. 

c) To actually put the machine code into the array, a series of 
POKE statements are used, i.e: 

POKE AD,30,7,14,1,205,5,0,201 

NOTE: the machine code must be given as decimal numbers. 

d) Finally, to execute the machine code, all that is required is 

X=CALL(AD) 

where X is a dummy variable and AD is the start address of the 
machine code as obtained in (b) above. 

NOTE: It is vitally important that DEFSEG is set to 0 when the 
CALL is executed. If DEFSEG is altered in the program, DEFSEG=0 
must be executed before the CALL is executed. It is also 
important that no attempt be made to use the array which is 
holding the machine code in the Basic program. 

4.8.6.2 PAGING IN MACHINE CODE 

In some applications the user may wish to access other pages 
from a machine code program. However, this is not a trivial 
matter and extreme care must be taken when using this facility. 
The user is recommended to read section 3.3.1 of this manual for 
full details on the HUNTER memory organisation before 
proceeding. 

In order to use the HUNTER paging, the machine code to switch 
the page must be located in the common block of ram starting at 
49152 (COOOH). If the machine code is not in this block of ram, 
the HUNTER will not be able to access the machine code program 
once the page has been switched. In order to ensure the machine 
code is located above 49152 (COOOH) the array used to hold the 
machine code is the last array dimensioned. Check the start 
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address of the array using VARPTR. If the address returned is 
still below 49152, use a dummy array to push the start address 
of the array to above 49152. 


The paging control is accessed via an 'OUT (E0H),A' command, 
with the accumulator containing the required page number with 
bit 7 set to 1 

i.e: to switch to page RO, the accumulator should contain 
80H (128 decimal). 


VER.V09F 


PAGE 4 - 19b 



BASIC PROGRAMMING 


SECTION 4.8 


4.8.7 AVAILABLE RAM IN RO 

Basic source in HUNTER can extend for 54k, though there must be 
space for the symbol table. 

Fig 4.1, STORAGE USED BY BASIC, shows how program and arrays are 
stored in lower memory, simple variables and array definitions 
start at D700 and work down. The gap in the middle is available 
and unused, the amount being displayed using FRE. The limits 
are contained in memory locations ALIM and DEFLIM. The address 
contained at these locations indicates the position of the free 
space. 

Fig 4.1 STORAGE USED BY BASIC 


HUSKY memory 
limit 


SIMPLE 
VARIABLES & 
DEFINITIONS 


FREE SPACE 


BASIC 

PROGRAM 


O/S USE 


D700H 


(DEFLIM) 


(ALIM) 


100H 
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It should be remembered that these locations are allocated 
dynamically and are entirely dependent upon the program and 
store. Also, if CLEAR or a new program line is inserted then 
the data storage is removed, so DEFLIM will point to the top of 
memory and ALIM to the top of the program. Hence, the program 
should be RUN before using these values. Clearly, if Basic is 
only used to start a large machine code program then there will 
be no variables and only a small amount of Basic source. 

4.8.8 SYSTEM CALLS 

The system calls are all defined in section 3.5, CP/M INTERFACE. 
They should be used by CALLing location 5 with the relevant 
value in C for CP/M compatibility. NO guarantee is made of the 
contents of undefined registers on exit and in general all 
register contents will be destroyed. 

4.8.9 THE STACK 

The machine code stack pointer is initialised at switch on. It 
is not recommended that it should be moved as the system can use 
a considerable amount of stack space. Under no circumstances 
should routines be written which preclude the use of interrupts; 
V24 I/O uses them liberally. 


4.8.10 ON/OFF 

The key, as detailed in section 2.4.13, ON/OFF KEY, is software 
controlled. The keyboard should be scanned periodically in any 
user written software if manual power OFF is required. 

4.8.11 THE NSC800 

It is not proposed to go into software techniques, meaning of 
object code, etc., here as the NSC800 is totally software 
compatible to the Z80. A list of the machine code instructions 
is presented in section 9.4, NSC800 MACHINE CODE. Users are 
referred to any tutorial book on the Z80 for detailed 
programming information. 

4.8.12 EXECUTION TIME 

Of interest in machine code loops, etc., is the execution time 
of the program. The number of cycles used by each instruction 
is detailed in section 9.4, NSC800 MACHINE CODE. The cycle time 
in HUNTER is 250ns. 
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If serial data is received, then the routines will be 
considerably slower due to interrupts. 
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PROGRAMMING TECHNIQUES 


4.9 To the programmer, most of HUNTER'S features are likely to seem 

familiar and quite comparable with many other, less portable, 
microcomputers. 

To the operator, HUNTER is likely to be quite different from 
anything he's encountered before. This fundamental divergence 
in experience can present a major challenge to the skill of the 
programmer. 

Because HUNTER operators tend to be newcomers to computer 
techniques, and worse, tend to capitalise on HUNTER'S unique 
physical characteristics by using it far away from the comfort 
of the computer room, considerable demands are placed on the 
quality of the programming. These demands are met by making 
programs as error-free and 'bullet-proof' as possible, together 
with careful program structures. A HUNTER that interrupts a 
data entry sequence in the field with "Magnitude Error in 

Line." is not likely to be appreciated by the user, or 

worse, by his customers. 

Knowing that field operators would have difficulty in recovering 
from programming failures on the spot, HUNTER'S designers have 
provided a number of facilities that help overcome these 
difficulties. But because HUNTER'S programming has to have 
greater integrity than is ever required at the desk-top, there 
is no substitute for methodical discipline in programming. 

The contents of this section explain some techniques that are 
successfully used to provide reliable and ergonomically friendly 
user programmes. 

4.9.1 DATA CAPTURE TECHNIQUES 

A typical HUNTER application program consists of 3 segments: 

A 'Data Capture' segment 
An 'Inspection' segment 
A 'Transmission' segment 

All three segments are contained in a common program although 
treated as independent modules. All share a common database, 
the 'captured' information, generally stored in array 
structures. 

The operator (as opposed to the programmer) is given a limited 
range of options within this framework and never has access to 
the Basic interpreter. On power-up, HUNTER will typically 


VER.V09P 


PAGE 4-23 




basic programming 


SECTION 4.9 


present a menu-style choice of options, often based on the 
segments or modules themselves. 

Once a module is selected, HUNTER will lead the operator through 
a question and answer sequence until his objective is achieved. 
Consider the following data capture program: 

10 REM TELEPHONE NUMBERS 

20 REM THIS PROGRAM CAPTURES AND STORES NUMBERS 
30 REM UP TO 6 DIGITS LONG. THEY CAN THEN BE 
40 REM RECALLED OR LISTED ON A PRINTER. 

100 REM MODULE 0 WHICH FUNCTION? 

110 PRINT "PLEASE CHOOSE A FUNCTION, TYPE '1' TO ENTER 
DATA; '2' TO INSPECT OR '3' TO TRANSMIT", 

120 INPUT A 
130 IF A=1 THEN 200 
140 IF k-2 THEN 300 
150 IF A=3 THEN 400 

200 REM MODULE 1 DATA CAPTURE 
210 DIM DC 10) 

220 FOR N=1 TO 10 
230 INPUT D(N) 

240 NEXT N 
250 GOTO 100 

300 REM MODULE 2 INSPECT DATA 

310 PRINT "WHICH NUMBER DO YOU WANT TO INSPECT?" 

320 PRINT "PLEASE ENTER A NUMBER 1-10!", 

330 INPUT N 
340 PRINT D(N) 

350 GOTO 100 

400 REM TRANSMIT THE DATA 

410 FOR N=1 TO 10 

420 LPRINT D(N) 

430 NEXT N 
440 GOTO 100 

This very simple program demonstrates the basic features of much 
more complex data capture routines, but has one dramatic failing 
: it is not "bullet proof". 

If the operator does not stick precisely to the sequence laid 
down, the program will soon encounter a problem and resort to 
error messages that will not help a non-programmer. Because of 
this, the great majority of effort in programming HUNTER 
applications is devoted to preventing occurarices that might 
cause confusion. 
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HUNTER'S Basic interpreter contains many features designed to 
prevent the inexplicable happening in the field: but complex 
programs can sometimes outwit even their own authors! 

A simple solution to this problem is simply to add three more 
lines: 

50 0NERR0R 500 

500 PRINT "THAT CAN'T BE RIGHT - PLEASE TRY AGAIN" 

510 GOTO 100 

Now, all the error messages from the interpreter are intercepted 
and re-directed. The program simply tries again. This is fine, 
but the problem remains: the errors shouldn't be there in the 
first place! 

4.9.2 DATA STORAGE ARRAYS 

4.9.2.1 Types of Arrays 

Captured data is generally held in array structures created 
within HUNTER'S very large memory. There are three types of 
array: 

Simple Variables 
Double Precision 
Strings 

Simple Variables are used for storage of decimal values of up to 
6 digit accuracy. 

Double Precision arrays store numbers up to 14 digit accuracy, 
but use more memory. 

NOTE: Both these types store much larger numbers than indicated, 
but only by truncating the least significant digits. For 
example, the number 12345678 entered as a simple variable would 
be stored and reproduced as 12345600. 

String Arrays store every character, whether numeric or 
otherwise, literally. They can have any number of characters 
(up to a maximum of 255 characters in each string). Facilities 
are provided for converting strings to numbers and vice versa. 

4.9.2.2 Array Structures 

Every array is denoted by a name and placed in memory in a 
sequential table. Multiple arrays are packed in memory by Basic 
and accessed via a Symbol Table. 
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Individual array elements are identified by the array name and 
the element number, together with a character to identify the 
array type. For instance: 

NOTE: Arrays start from element 0 


A( 10) is the eleventh element of simple variable array A. 

A!(2) is the third element of double precision array A! (quite 
different and independent from array A in the example above). 

A$(0)is the first element in string array A$. A$(0) is 

identical with A$, which can be used for shorthand, useful if 
there are multiple references to a single string in the program. 

In each case, the number in parentheses is the element number, 
and can be variable: A$(A) 

or an expression: A$(A#5) 

or another array element: A$((6)) 

Remember the element numbers start from 0! 

4.9.2.3 Creating Arrays 

Arrays can only be created once: if a subsequent attempt is made 
to re-define an existing array, an error occurs. This is to 
warn the programmer that he may be accidentally duplicating an 
array hame. 

If the statement DIM A$( 1,6) is repeated at anytime an error 
message: 

*DIM Error 

will appear. 

This can be easily avoided by incorporating the DIM in a program 
sequence that is only executed once, and subsequently branched 
around. This is often called an Initialisation Sequence. A 
typical format is: 

10 IF ZOO THEN 100 
20 DIM A$(1,6) 

30 Z=55 
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The variable Z is a flag, indicating that the program has been 
run before. (All variables are cleared to 0 by CLEAR or any 
change to program content, but not by power off or removing 
batteries). 

A slightly more sophisticated version is: 

10 IF ZOO THEN 100 
20 DIM A$(1,6) 

100 Z=Z+1 

Where Z acts both as a flag and as a counter of the number of 
times the program has been run, a very useful statistic! 

4.9.2.4 Array Sizes 

Arrays are limited in size only by HUNTER'S memory space. 
Remember that arrays compete with program for space, 
automatically allocated by HUNTER'S operating system. 

Array size allocation is simplified by self-sizing. For this 
purpose, the Function FRE can be used as a variable. FRE 
provides the number of memory bytes remaining as follows: 

After NEW : The total memory available 

After program entry : The memory available for data 

After array definition : The memory remaining 

The number FRE can be used to automatically calculate the max¬ 
imum number of array elements possible for any given array type 
and to sign on informing the operator of this information. 

10 IF ZOO THEN 100 
20 N=2 

30 Y=INT (((FRE(0)-7-N*7)/5)-1) 

40 DIM A(Y) 

100 PRINT "TOTAL NUMBER OF ELEMENTS AVAILABLE:",Y 

Note that Y is taken as an integer (INT), that the symbol table 
entry (-7) is subtracted, that the element size is 5 bytes and 
that arrays start from zero, so the maximum number is one less 
(-1). N*7 is an allowance for the number of variables used in 

the subsequent program, assuming 7 bytes per variable. 


NOTE: arrays can also be copied to files. See section 4.14.1 
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A string array can be sized as follows: 

10 IF ZOO THEN 100 
20 N=2 

30 Y =INT (((FRE(0)-7-N*7-256)/15)-1) 

40 DIM A$(Y,4) 

100 PRINT "TOTAL NUMBER OF STRINGS AVAILABLE:»,Y 

4.9.2.5 Accessing Array Elements 

Each element in a data array is accessible by its array index, 
expressed in parentheses, e.g: 

A$(235) 

is the 236th element in A$ 

NOTE: Array indexes must be within the range declared in the 
corresponding DIM statement. HUNTER Basic warns the programmer 
of any attempt to access an element outside the declared range 
with: 


*MAG Error 

Be especially careful with incrementing indexes like FOR NEXT 
loops. 

Array indexes often have a direct relationship to external 
variables, like stock codes. It is always preferable to 
directly access an array in this fashion in the interests of 
speed, rather than working sequentially through every element. 

If there are discontinuities (gaps) in the existing codes, or if 
the numbers are too large, a conversion table or algorithm may 
be needed. Since a literal table (one entry for every code) is 
likely to be very inefficient, it is generally worth putting 
considerable effort into deriving an efficient 'tree' structure 
for direct array access. 

4.9.2.6 Array Searches 

There is often a need to search an array for an element of known 
content. In Basic, this procedure can be painfully slow. 

One solution to this dilemma is to use a specialised machine- 
code subroutine to search the array and return with the index of 
the target element. 
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A much more practical method is the Basic function SRCH. 

4.9.3 DATA INPUT TECHNIQUES 

We are all familiar with the computer truism: 

"Garbage in - garbage out" 

This was never more true than in data capture applications where 
out-of-range entries can cause fatal errors that are just 
embarrassing in the office, but potentially disastrous in the 
field. 

To help avoid the most common form of data entry error, HUNTER 
provides a unique facility INPUT USING. Input using pre-filters 
incoming data against a predetermined mask and rejects entries 
that do not fit at the keyboard, warning the operator to try 
again. 

Equally important to the user is optimum use of HUNTER'S screen 
to provide clear, unambiguous prompt messages and input fields. 

4.9.4 USING HUNTER'S SCREEN 

HUNTER'S large, 40 x 8 character, LCD screen can be used to 
positive effect to help its operator. Because the screen is 
entirely flexible, these notes are provided as a source of ideas 
rather than as instructions. 

This section refers to character-by-character use, more detailed 
information on direct dot addressing is available in Section 
4.7, HUNTER GRAPHICS. 

4.9.4.1 The Virtual Screen 

HUNTER'S 40 x 8 character, LCD screen acts as a window to a much 
larger virtual screen. When characters are written to the screen 
from a Basic program they are always written to the virtual 
screen. The commands available in Basic to move the window are 
•CLS', 'INPUT' and 'LOCATE'. 

'CLS' Clears the virtual screen and sets the window to the 
top left of the virtual screen. 

'INPUT' The execution of an 'INPUT' command will move the LCD 
window to the part of the virtual screen containing 
the 'INPUT' prompt. 
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'LOCATE' The Locate command will re-position the cursor in the 
virtual screen and will move the window so that the 
cursor remains visible. 

4.9.4.2 Cursor Addressing 

The cursor position can be commanded from a Basic program, 
allowing characters to appear anywhere on the screen. Cursor 
addressing is relative to the virtual screen, therefore 
characters may not appear on the LCD screen in text mode. 

The standard Basic format for cursor addressing is: 

LOCATE X,Y 

X and Y are the co-ordinate values expressed in decimal. 

4.9.4.5 The Standard Header Page 

All HUNTER programmes generated at HUSKY Computers feature a 
standard header page. The header page supplies vital information 
about the program and use of this format is strongly advocated 
to other users. 

The appearance of a suitable user header page would be:- 


20 Oct 1983 


OPTIONS 

1 = ENTER DATA 

2 = REVIEW DATA 

3 = AMEND DATA 

4 = TRANSMIT DATA 


11:20:32 


PLEASE ENTER OPTION NUMBER ? 


4.9.4.6 Dynamic Screens 

A vital ergonomic factor in HUNTER program design is 
reassurance. Many, perhaps most, HUNTER operators have never 
worked with any kind of computer before and are likely to have 
some suspicion about this example of 'advanced technology'. 

The crucial point is that HUNTER MUST COMMUNICATE WITH THE 
OPERATOR. If it doesn't he'll soon become frustrated at some 
situation he doesn't understand and resort to 'traditional' 
solutions - gently encouraging it with, a series of sharp blows 
or worse! 
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4.9.5 HELP STATEMENT 

The HELP facility provides a means of breaking into normal 
programs to display text for operator assistance. 

After the HELP text has been read control is returned to the 
main program, as if nothing had happened, by pressing the 'HELP' 
key again. 

4.9.5.1 The Help Vector 

The text displayed by HELP can be linked to the operation 
currently being performed. The start position of the text can be 
set under program control. This is achieved by the pair of ram 
locations 'VECTOR', indicating the memory address of the start 
of text. This is controlled by the HELP function in Basic. 

VECTOR can also be set by POKE. 

4.9.5.2 Text Storage 


Help text is stored by means of REM statements, which allow 
storing of ASCII text within programs. 

The address in the Help vector points to the start of the line 
number. The Help program will skip forward over the first four 
bytes, checking the REM token and then displaying the text. 

NOTE: The REM token is stored as 143 Decimal, (8FHex). 

Fig 4.2 TEXT STORAGE, shows how the following line of Basic 
source code is stored: 

10 REM ABCDEFCHI 


Fig 4.2 TEXT STORAGE 
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4.9.5.3 HELP Text Display 

The software which controls HELP will scroll forward through the 
lines of Basic text, or pseudo-Basic text, until the verb found 
is not a REM. Scrolling backwards is also allowed until a line 
is found without a REM. In each case, further scrolling is not 
allowed. 


4.9.5.4 Storing the Current Display 

The contents and cursor position of the screen are not lost 
while in HELP mode. On exit from HELP mode, the screen and 
cursor are restored to their states prior to HELP mode entry. 

4.9.5.5 HUNTER Action during HELP 

When a program is interrupted for HELP display all normal action 
is suspended. Serial data reception will continue up to the 
capacity of the receive buffer. If handshaking is enabled then 
it will continue in a transparent fashion. 

Programs will continue after the HELP key is pressed again. 

HELP will be entered during any scan of the keyboard, whether 
for status or waiting for an actual key depression. 

4.9.5.6 Graphics Mode 

Because HUNTER'S graphics screen cannot be re-created from RAM 
memory, HELP text would destroy the contents of the screen if 
allowed during graphics mode. For this reason, HELP is 
inhibited in graphics mode and help key depressions are ignored. 
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POWERWARNING 


4.10 When HUNTER's batteries become exhausted a power warning message 
will appear on the screen. Normal operation will continue, but 
keyboard entries will be punctuated by warning tones and 
repetition of the power warning message until the battery state 
is rectified either by replacement of primary cells or 
recharging of Nickel-Cadmium cells, if installed. 

Eventually, if the warnings are ignored, HUNTER will shut down 
and refuse to operate further. 

Every HUNTER has to pass a stringent operating test in this low 
power regime. However, it is strongly recommended that operator 
training procedures and user programs are structured to avoid 
continued operation when warnings become persistent, especially 
when rechargable cells are used. 

The power warning sequence may be misleading if RS-232 
communications are used infrequently. When HUNTER'S 
communications system is activated power drain increases 
significantly. This increase can cause the power warning stage 
to be missed altogether, and instead cause HUNTER to shut down 
without warning. 

While this is not hazardous, it can be very confusing for an 
operator who does not know what is wrong. Because of this it is 
recommended that user programs with infrequent communication 
requirements use a test routine. This activates the 
communications package, and then tests the power state before 
restoring HUNTER to normal. This routine is used at the start 
of every data entry sequence. 

If batteries become exhausted whilst communications are in 
progress, then normal power warning messages will appear once 
the keyboard operation is resumed. 

NOTE: Power warning messages only occur when keyboard entries 
are in progress. 

SAMPLE WARNING SUBROUTINE 

20 OUT 132,1 
30 J=INP(2):0UT132,0 

40 IF J AND 4 = 0 THEN RETURN 
50 CLS 

60 PRINT "PLEASE CHANGE MY BATTERIES!" 

70 BEEP:BEEP:BEEP:BEEP 
80 RETURN 
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This program operates as follows: 

1) The power status is available as bit 2 in HUNTER port 2. 

0 = power OK, 1 = Low Power state. 

2) Line 20 energises the RS-232 serial interface. 

3) Line 30 reads the power state from port 2, and then closes 
down the interface to conserve power. 

4) Line 40 checks the power status bit. 

5) Line 50-80 Display a warning and ring HUNTER'S beli 1 


VER.V09F 


PAGE 4-34 



BASIC PROGRAMMING 


SECTION 4.11 


OFF-LINE PROGRAM STORAGE 


4.11 Most HUNTER applications require storage of users' Basic source 
programs in an easily accessible bulk-memory system for support, 
updating, exchange and maintenance. 

One very popular method of storing HUNTER programs is in user's 
multi-access mainframe database systems, although minis, micros 
and other HUNTERs are also used extensively. HUNTER'S ability 
to communicate freely with these other systems is vital to 
supporting its programming and application. 

This section deals with both manual and programmed source code 
loading and unloading using Basic's complementary LLIST and 
LLOAD commands. 

4.11.1 LLOAD 

LLOAD is the command for loading Basic source programs into 
HUNTER. It may be used to load entire programs or to modify 
existing ones by appending or overwriting lines. 

LLOAD can be used with any of the communications protocols 
detailed in Part 6, COMMUNICATIONS. During LLOAD no text is 
echoed to the screen, to speed up the facility. Certain 
speed/protocol limitations are detailed below. 

4.11.1.1 Manual Control 

To enter program lines, simply type 'LLOAD' followed by carriage 
return. HUNTER will then load to memory source text presented 
on the serial port. Note that syntax is checked on a line by¬ 
line basis and that if an error is detected, the LLOAD will 
terminate and a 'SYX Error' will be displayed on the screen. 

If the program provided overflows the memory space available, a 
'MEM Error' will appear. 

LLOAD mode can be terminated by pressing 'ESC' on HUNTER'S 
keyboard or 'power off'. (Data will not be lost). 

Alternatively, an 'ESC' character sent over the interface will 
return control to the keyboard. 
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4,11.1.2 Programmed Control 

Logically, it is difficult for a program to append to or modify 
itself, since the sequence controlling the modification may be 
modified as well! However, HUNTER programs can contain 
sequences that will command a remote processor to send program 
text and then accept that text as Basic source. 

Current versions of HUNTER Basic do not support LLOAD as a 
program statement, e.g. 100 LLOAD. However, the 'Logical 
Keyboard' Flag has the same effect as LLOAD and can be commanded 
in a program as a 'POKE' instruction. By setting the flag to 
the serial input port and then returning to interpreter mode, 
HUNTER is configured to accept new program lines. These lines 
may overwrite the lines originally used to enter the LLOAD mode. 

Loading may be terminated by sending an unnumbered 'RUN' state¬ 
ment which will cause execution to re-commence from the start of 
the new or updated Basic program, making the load sequence 
virtually transparent to the operator. 

A possible program format might be: 

100 REM Program reload routine 

110 INPUT "Please enter new program name", X3$ 

120 LPRINT "Hi there, mainframe. Please transmit file name", 

130 LPRINT X3$ 

140 POKE IX,1 : REM This sets the logical keyboard as the 

serial input port 

150 END : REM Returns control to the interpreter 


,The new program lines now load 


. The last line transmitted is unnumbered RUN, which executes: 

10 POKE LK,128 : REM Restore the logical keyboard 
20 PRINT "New program loaded OK : Continue?" 

Variable LK is the address of IFFLAG, addresses of memory 
locations may be found in section 9.7, MEMORY LOCATIONS. 

HUNTER'S input buffer ensures that the first line of program is 
captured, no matter how quickly the distant computer responds. 
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4.11.1.3 IMPORTANT NOTE 

In present versions of HUNTER operating system, any alteration 
to program content, including deletion of lines, automatically 
clears all variables and arrays. This is essential to HUNTER'S 
operation, but means that data cannot be carried across reload 
boundaries. Data copied to files is not affected, however. 

4.11.2 LUST 

LLIST is the principal method of copying and recording HUNTER 
programs. 

Invoking LLIST causes program lines to list sequentially from 
the lowest line number or from a line number specified as an 
argument in the LLIST. Examples are : 

LLIST Lists an entire program 
LLIST 170 Lists from line 170 

LUST 2133 Lists from 2133 or, if 2133 does not exist, from the 
next highest line. 

LUST terminates when all line numbers are listed, when 'ESC' is 
pressed or when HUNTER is powered down. Data will not be lost 
if HUNTER powers down during a listing. 

LLIST cannot be incorporated in a program, and is only available 
for manual use. 

Protocol and format selections made in HUNTER'S communication 
package are observed transparently by LLIST. Carriage Return 
terminator characters are provided at the end of each program 
line, line feed and null characters are optional. 

IMPORTANT NOTE 

Remember that HUNTER'S communication system needs to power up to 
its RS-232 state for transmission to occur. This power-up will 
cause an off-to-low transition that many systems will read as a 
single, spurious, character. This event only occurs once and 
can be avoided by powering up the interface prior to activating 
a receiving device. Methods of pre-powering the interface 
include : 

LPRINT " " : REM the interface powers up automatically 

OUT 132,1 : REM Direct control of the communications inverter 
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Remember that once powered up, the RS-232 output remains active 
until HUNTER is powered down or the inverter is commanded 'off' 
by : 

OUT 132,0 

HUNTER power consumption increases substantially during RS-232 
transmission with corresponding reduction in battery life. 

It should be noted, however, that if the RS-232 line is powered 
off further serial transmission will be lost unless the inter¬ 
face is powered up again, by: 

OUT 132,1 

NOTE: The interface will not power-up automatically with a 
simple LPRINT statement with no argument. 

4.11.3 SPEED/PROTOCOL LIMITATIONS 

It is always advisable that some form of protocol handling is 
established between HUNTER and associated computers. 

Some multi-access mainframes and some popular microcomputers are 
unable to support any form of protocol, however. 

In these cases, HUNTER will generally support direct program 
transfer at speeds of 1200 baud or less. At higher speeds, 
HUNTER'S input buffer may overflow leading to loss or truncation 
of lines. At 1200 baud, the buffer smooths the flow of incoming 
program through HUNTER Basic's syntax checking routines. 

Problems with truncation will invariably lead to the load 
operation being aborted and a 'SYX Error 1 message being dis¬ 
played, since the Interpreter will not accept partial lines. 

The capability of supporting simple 1200 baud communication is 
invaluable in many situations. 

4.11.4 COMMUNICATIONS WITH DATABASES 

A very useful HUNTER feature is the ability to communicate 
directly with mainframe databases using TERM. 

This interactive mode can be used manually to establish logon 
procedures, passwords, etc., before attempting to transfer or 
copy files or inspect data. 

Sequences proven out manually can in most cases be implemented 
in HUNTER Basic as automatic features of the user's program once 
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protocols, etc, have been finalised. Such sequences can present 
inputs to the mainframe and inspect the reply for keywords like 
'READY' or simple cursor prompts. 

MOTE: Many mainframes are unpredictable in the response they 
provide to login sequences, with variable 'welcome' or 'news' 
messages. Make sure your automatic sequence is robust enough to 
handle these eventualities! 

Some general points about database communications should be 
noted: 

4.11.4.1 Rate 

Communication occurs generally at 300 baud, although other 
configurations are possible. Remember that the screen 
character generator will display all ASCII characters, even if 
they are not shown on the keyboard. 

Other rates encountered on dial-up systems are 110 (very rare) 
and 1200, but only with sophisticated modems. 

4.11.4.2 Parity 

Dial-up systems can expect any of even, odd or no parity 
selections. Transmit and receive parities are generally the 
same. Always use receive parity if it is available - the 
occasional appearance of the parity error symbol is a useful 
indication of bad lines. Remember that telephone lines can be 
bad in one direction only. 

4.11.4.3 Full/Half Duplex 

Database systems vary widely in the use of full or half duplex 
operation. 

Full duplex occurs when the host system 'echoes' every received 
character back to HUNTER. In this mode, HUNTER'S transmission 
echo should be selected 'off' so that characters typed on the 
keyboard only appear on the screen if they have completed the 
whole circuit of HUNTER - Mainframe - HUNTER. 

Basic routines can check full duplex replies as an absolutely 
secure communication protocol, provided the mainframes' own 
messages don't confuse the issue. 
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If the echo switch is left 'on', double characters will appear 
on the screen. This in no way affects communication, but makes 
outgoing messages hard to read! 

Half duplex occurs when the host does not echo characters back 
to HUNTER. In this situation, the echo switch should be 'on 1 to 
allow outgoing messages to be read by the operator. This method 
does not guarantee that data sent to the host is being correctly 
interpreted. 

A third mode, Simplex, occurs when data is sent in only one 
direction at one time and is otherwise similar to Half duplex. 
HUNTER is not concerned which mode is in use. 

4.11.4.4 Protocol 

Unfortunately, very few dial-up databases support any kind of 
protocol, so that generally HUNTER’S 'none' option should be 
used. Note that 1200 baud is the fastest recommended speed for 
no protocol program loading. 

However, some systems do support 'X0N/X0FF' although implement¬ 
ations vary between computers - seek advice from HUSKY Computers 
if difficulty is encountered. 

4.11.4.5 Other Parameters 


The setting of 'NULL 1 and ’LF' are generally not material in 
mainframe communication, so that '0' is recommended for NULL 
count. See below for LF. 

4.11.4.6 Terminator 

HUNTER'S 'ENTER' key generates CR (Carriage Return), but some 
mainframes expect other terminators. Examples are Control C and 
LF (Line Feed), or 'New Line'. Consult your computer manual for 
details. 

4.11.4.7 Delete 

HUNTER'S DEL (Delete) key generates 'rubout'. Few mainframes 
recognise this, or in many cases allow any deletion at all! 
'Cursor left' may work in some cases. 

4.11.5 ACOUSTIC COUPLERS 

Good quality communication can often be achieved over surprising 
distances with acoustic couplers at 300 baud, but this method is 
not recommended for routine daily use. 
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4.11.6 EXTRA DOCUMENTATION LINES 

It. is worth knowing that source files kept on computer systems 
can have further documentation within them by using unnumbered 
'REM' lines, e.g. 

100 PRINT "HELLO" 

REM This line of text will be ignored by HUNTER only line 
100 will load into HUNTER. 

This prevents loading unnecessary text. Naturally, these lines 
can only be created on the host or database computer. 
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AUTO POWER FEATURE 


4.12.1 Basic supports several powerful functions associated with the 
POWER key. Basic programs can control precisely what occurs on 
switch on, or even not allow HUNTER to be turned off. The 
following commands and statements are available: 

ON POWER GOTO 
ON POWER RESUME 
POWER CONT 
POWER n 
POWER OFF 
POWER OFF RESUME 


4.12.2 DEFAULT CONDITIONS 

The power key behaves as normal - at any stage it can be used to 
turn HUNTER on or off. The current execution position is lost 
on turning the power off, and turning it back on returns to the 
File Manager. However the current Basic program and variables 
are retained. 


4.12.3 POWER CONT 

a) The power key is disabled. 

b) The automatic timeout power down (if no key is pressed within 
a set period of time) is disabled. 


4.12.4 POWER n 

a) This command overrides a previous POWER OFF. 

b) n refers to the automatic power down timeout: 

1) n must be in the range 10-255 or 0 

2) n=0 is no automatic timeout 

3) n is in mutiples of 5 seconds 


4.12.5 POWER OFF 

a) Turns the power off. 

b) When power is turned on, Basic program execution starts at 

the beginning. 
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4.12.6 


4.12.7 


4.12.8 


4.12.9 


POWER OFF RESUME 

As POWER OFF, but turning HUNTER on continues execution where it 
left off. 

ON POWER GOTO 

When the power button is hit (during program execution) program 
execution goes to the specified line number. 


ON POWER RESUME 

a) Powering down proceeds as normal. 

b) Powering up begins program execution where it left off. 


Timeouts 

HUNTER has an automatic timeout (see section 2.8.8). This can 
be modified using POWERn, If HUNTER has been switched off, the 
power down timeout is set back to the default of 5 minutes 
unless CONT (see section 3.4.3.4) or Power OFF RESUME (see 
section 4.12.6) has been used. 
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4.13.1 


4.13.2 


4.13.3.1 


4.13.3. 


4.13.3. 


FILE HANDLING 


HUNTER'S Basic interpreter provides the user with the necessary 
commands and statements to communicate with the File Manager as 
follows: 


CLOSE 

MAXFILES 

EOF 

NAME 

INPUT// 

OPEN 

KILL 

PRINT// 

LOC(n) 

WRITE# 


HUNTER'S File Manager supports the use of sequential access 
files. Files are stored in HUNTER'S RAM memory, but HUNTER'S 
Basic interpreter will treat them as if they were disk files for 
reading and writing. 


File Numbers 

When files are OPENed for input or output they are assigned a 
'file number' which is specified by the 'AS' parameter. The 
'file number' cannot be greater than the value specified in 
MAXFILES, If no MAXFILES have been specified a default value of 
one is taken. A file is always referred to by its 'file 
number'. 


File Handling Commands 

A brief description of the file handling commands and statements 
follow, further details may be found in the relevant section of 
Part 5, Basic Functions. 


CLOSE# 

When files have been OPENed for reading or writing and no 
further access is required CLOSE will write the end of file 
marker (EOF) to the file. 

EOF 

When reading data from a file a check must always be made after 
every INPUT// statement for end of file, an attempt to read past 
the end of file will produce an error. 
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4.13.3.4 INPUT# 

This command is used for reading data from a file. 


4.13.3.5 KILL 

Used for deleting files from within a Basic program. The file 
must first be CLOSEd if it has previously been OPENed for 
reading or writing. 


4.13.3.6 LOC(n) 

This will return the number of records that have been read or 
written to a file. The parameter (n) refers to the 'file number' 
associated with the file. 


4.13.3.7 MAXFILES 

Sets the maximum number of files that may be opened simul¬ 
taneously; if it is not specified a default value of one is 
taken. MAXFILES will perform a CLEAR operation when it is 
executed, destroying all symbol table entries. Therefore it 
rrust be defined at an early point in the program. 


4.13.3.7 NAME 

This will re-name a file from within a Basic program. 


4.13.3.8 OPEN 

Before a file can be read or written to it must first be OPENed. 
The OPEN command has as one of its parameters 'FOR' which has to 
be specified with one of three options which are: 

OUTPUT = Opens and clears file ready for output. 

APPEND = Opens a file for output. Records written are added to 
the end of the file. 

INPUT = Opens a file for reading. 
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4,13.3.9 PRINT# 

Data is output to the file. Each variable must be delimited by 
a comma. 


4.13.3.10 WRITE# 

Data is output to the file, variables do not need to be 
delimited by commas. 
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ERRORS AND WARNINGS 


4.14 HUNTER'S Basic Interpreter will display one of a number of 
messages on an error occurring. 

The messages have three characters, generally with a line 
number. The meaning may be found with reference to the 
following Table 4.14. They are aimed at experienced 
programmers. 

Each error has an error number. This is the value returned by 
the ERR verb and is useful during error trapping. 
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TABLE 4.14 



MESSAGE 

NO. 

MEANING 

ARG 

0 

ARGUMENT ERROR: A function has been called 
with an out of range argument. 

STX 

1 

SYBITAX ERROR: Incorrect syntax in a Basic 
statement. 

CSK 

2 

CONTROL STACK ERROR: Incorrect FOR...NEXT; 
WHILE...WEND or GOSUB...RETURN construction. 

SSK 

3 

SYSTEM STACK ERROR: Attempt to POP a non- 
existant variable. 

DIN 

4 

DIRECT INPUT ERROR: Use of a meaningless 
Basic statement as a command, e.g. NEXT. 

DIM 

5 

DIMENSION ERROR: Attempt to redefine an 
existing variable. 

FP 

6 

FLOATING POINT ERROR: Illegal maths 
operation, e.g. B=A/C where C=0. 

LNo 

7 

LINE NUMBER ERROR: Reference to a non- 
ex istant line number. 

SQR 

8 

NEGATIVE SQUARE ROOT: 

MAG 

9 

MAGNITUDE ERROR: Reference to an array 
element larger than the array dimension. 

RD 

10 

READ ERROR: The data statement is either 
invalid or non-existant. 

MEM 

11 

STORAGE OVERFLOW: Variable storage or array 
overflowed available memory. 

ARY 

12 

ARRAY ERROR: Use of an element in an un¬ 
defined array. 

BAS 

13 

BASIC SOURCE ERROR: Attempt to run a non- 
Basic program. 

HLP 

14 

HELP SOURCE ERROR: The HELP statement has 
an illegal line number reference. 
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TABLE 4.14 Contd.. 


MESSAGE 

NO. 

MEANING 

r rYP 

15 

TYPE MISMATCH ERROR: Received string data 
type instead of numeric. 

STR 

16 

STRING COMPLEXITY ERROR: Insufficient space 
to manipulate a string expression. 

RES 

17 

RESUME WITHOUT ERROR: 

FNF 

18 

FILE NOT FOUND: Reference to a non-existant 
file. 

IFN 

19 

ILLEGAL FILE NAME: Filename does not 
conform to standards of file names. 

FOP 

20 

FILE ALREADY OPEN: 

FNO 

21 

FILE NUMBER ERROR: File number greater than 
MAXFILE. 

FCL 

22 

FILE CLOSED ERROR: 

FOO 

23 

FILE OPEN FOR OUTPUT ERROR: 

FOI 

24 

FILE OPEN FOR INPUT ERROR: 

WWD 

25 

WHILEAJEND ERROR: WHILE without WEND or 
without WHILE. 

DSK 

26 

DISC ACCESS ERROR: 

??? 

27-255 

USER DEFINED ERROR: 
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INDEX TO BASIC FUNCTIONS 


5.2.1 

ABS 

Function 

Returns absolute value of argument 

5.2.2 

ARC 

Function 

Sets up argument for CALL 

5.2.3 

ASC 

Function 

Returns decimal equivalent of string 

5.2.t( 

at r: 

Function 

Returns Arc-Tangent of argument 

5.3.1 

BEEP 

Command 

Generates tone from sound generator 

5.4.1 

CALL 

Statement 

Calls machine-code subroutine 

5.4.2 

CHAR 

Function 

Specific character set in graphics mode 

5.4.3 

CHR$ 

Function 

Returns string equivalent of argument 

5.4.4 

CIRCLE 

Statement 

Draws circle on LCD 

5.4.5 

CLEAR 

Command 

Clears all variables 

5.4.6 

CLOSE 

Statement 

Closes files 

5.4.7 

CLS 

Command 

Clears the display screen 

5.4.8 

COM 

Command 

Activates/deactivates communications 
interrupt 

5.4.9 

CO NT 

Command 

Continues execution of program 

5.4.10 

COS 

Function 

Returns cosine of argument 

5.4.11 

CRT 

Command 

Switches console to RS-232 port 

5.4.12 

CUROFF/ 

CURON 

Command 

Switches cursor off and on 

5.5.1 

DATA 

Statement 

Holds data for use by program 

5.5.2 

DATES 

Function 

Returns current date string 

5.5.3 

DAYS 

Function 

Returns current day string 

5.5.4 

DEFSEG 

Command 

Defines RAM page 

5.5.5 

DELETE 

Com,land 

Delete program lines 

5.5.6 

DIM 

Statement 

Initialises arrays 

5.6.1 

EDIT 

Command 

Enters Basic editor 

5.6.2 

El® 

Statement 

Terminates execution 

5.6.3 

EOF 

I/O Function 

Detects end of file 

5.6.4 

ERR/ERL 

Function 

Returns error code/line number 

5.6.5 

ERROR 

Statement 

Simulates Basic error 

5.6.6 

EXP 

Function 

Returns e to the power of the argument 

5.7.1 

FILES 

Command 

Displays current files 

5.7.2 

FIX 

Function 

Strips argument to integer 

5.7.3 

FOR 

Statement 

Starts FOR...NEXT loop 

5.7.4 

FRE 

Statement 

Returns number of free bytes 

5.8.1 

GOSUB 

Statement 

Branches to subroutine 

5.8.2 

GOTO 

Statement 

Branches to alternative line 

5.9.1 

HELP 

Statement 

Initialises HELP key text pointer 

5.10.1 

IF 

Statement 

Conditional branch 

5.10.2 

IF..THEN.. 

Statement 

Conditionally executes one of two 


ELSE 


statements 
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5.10.3 

INCHR 

I/O Statement 

5.10.4 

INKEY 

I/O Statement 

5.10.5 

INKEY$ 

I/O Statement 

5.10.6 

INP 

I/O Statement 

5.10.7 

INPUT 

Statement 

5.10.8 

INPUT USING 

Statement 

5.10.9 

INPUT# 

I/O Statement 

5.10.10 

INSTR 

Function 

5.10.11 

I NT 

Function 

5.11.1 

JSR$ 

Function 

5.12.1 

KEY 

Command 

5.12.2 

KEY(n) 

Command 

5.12.3 

KILL 

Command 

5.13.1 

LEFT$ 

Function 

5.13.2 

LEN 

Function 

5.13.3 

LET 

Statement 

5.13.4 

LINCHR 

I/O Statement 

5.13.5 

LINE 

Statement 

5.13.6 

LINPUT 

I/O Statement 

5.13.7 

LIST 

Command 

5.13.8 

I,LI ST 

I/O Statement 

5.13.9 

LL0AD 

Statement 

5.13.10 

LN 

Function 

5.13.11 

LOAD 

Command 

5.13.12 

L.0C 

I/O Function 

5.13.13 

LOCATE 

Command 

5.13.14 

LOG 

Function 

5.13.15 

LOPCHR 

I/O Statement 

5.13.16 

[.PRINT 

I/O Statement 

5.13.17 

LTRON 

1/0 Statement 

5.14.1 

MAXFILES 

I/O Statement 

5.14.2 

MID$ 

Function 

5.15.1 

NAME 

Command 

5.15.2 

NEW 

Command 

5.15.3 

NEXT 

Statement 

5.16.1 

ON BREAK 

I/O Statement 

5.16.2 

ON COM 

1/0 Statement 

5.16.3 

ON COMMS 

I/O Statement 

5.16.4 

ON ERROR 

Statement 

5.16.5 

ON G0SUB 

Statement 


Returns single character from keyboard 

Returns keyboard status 

Returns single character from keyboard 

if input pending 

Returns value at port address 

Returns data input from keyboard 

Validates data input from keyboard 

Input data from file 

Returns position of second string in 

first string 

Returns integer part of argument 

Returns fixed-field string 

Initialises soft keys 
Activates/deactivates soft keys 
Deletes file 

Returns left part of string 

Returns lengths of string 

Assigns value of variable 

Returns single character from RS-232 

Draws straight line 

Returns entry from RS-232 

Lists program at LCD 

Lists program at RS-232 

Loads program from RS-232 

Returns natural logarithm 

Loads program from file 

Number of records read/written 

Sets cursor position 

Returns logarithm to base 10 

Sends single character to RS-232 

Outputs to RS-232 

Sends trace output to RS-232 

Maximum no. of files to be opened 
Returns mid portion of string 

Re-names file 
Initialises program space 
Concludes FOR...NEXT loop 

Vectors program on BREAK key 
Vectors program on communication 
Vectors program on COMMS failure 
Vectors program! on Syntax error 
Conditional branch to subroutine 
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5.16.6 

ON GOTO 

Statement 

5.16.7 

ON KEY 

I/O Statement 

5.16.8 

ON POWER 

I/O Statement 

5.16.9 

ON POWER 



RESUME 

I/O Statement 

5.16.10 

ON TIME$ 

Statement 

5.16.11 

OPCHR 

Statement 

5.16.12 

OPEN 

I/O Statement 

5.16.13 

OUT 

I/O Statement 

5.17.1 

PEEK 

Statement 

5.17.2 

PI 

Statement 

5.17.3 

POINT 

Statement 

5.17.4 

POKE 

Statement 

5.17.5 

POP 

Statement 

5.17.6 

POS 

Statement 

5.17.7 

POWER 

Statement 

5.17.8 

POWER CONT 

Command 

5.17.9 

POWER OFF 

Command 

5.17.10 

POWER OFF 



RESUME 

Command 

5.17.11 

5.17.12 

PRINT 

Statement 

5.17.13 

PRINT# 

I/O Statement 

5.17.14 

PSET/PRESET 

Statement 

5.17.15 

PUSH 

Statement 


5.19.1 

READ 

Statement 

5.19.2 

REM 

Statement 

5.19.3 

RESTORE 

Statement 

5.19.4 

RESUME 

Statement 

5.19.5 

RETURN 

Statement 

5.19.6 

RIGHT$ 

Function 

5.19.7 

RND 

Function 

5.19.8 

RUN 

Command 

5.20.1 

SAVE 

Command 

5.20.2 

SCREEN 

Command 

5.20.3 

SGN 

Function 

5.20.4 

SIN 

Function 

5.20.5 

SOUND 

Command 

5.20.6 

SPACE$ 

Function 
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Conditional branch 
Vectors program on soft keys 
Vectors program on POWER key 

Restarts program on power up 
Vectors program on system time 
Outputs 1 or more ASCII characters 
Opens file for input/output 
Outputs to specified port 

Returns decimal byte value of memory 
locations 

Value of PI = 3.14159 
Returns condition of pixel 
Sets memory location with decimal 
value 

Returns value from machine 

code linkage/stack 

Returns cursor position 

Specify auto time off 

Disables power off key and time outs 

Switches HUNTER off 

Switches HUNTER off 
Outputs to LCD 

Output data to file 
Set/re-set pixel 
Puts value onto machine code 
linkage stack 

Returns value from DATA statement 
Enters remarks to Basic text 
Resets Read pointer 
Restarts program at specified line 
Returns from subroutine 
Returns right portion of string 
Produces random number 
Starts a program execution 

Writes program to file 

Changes screen mode 

Returns a value for the sign of its 

argument 

Returns Sine of argument 
Generates specified tone 
Returns string of spaces 
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20.7 

SPC 

Function 

20.8 

SQR 

Function 

20.9 

SRCH 

Function 

20.10 

STOP 

Statement 

20.11 

STR$ 

Function 

20.12 

STRINGS 

Function 

20.13 

SWAP 

Function 

21.1 

TAB 

I/O Statement 

21.2 

TAM 

Function 

21.3 

TIMES 

Function 

21.A 

TR0H/TR0FF 

Command 

23.1 

VAL 

Function 

23.2 

VARPTR 

Function 

24.1 

WAND 

Command 

24.2 

WHILE. .WE® 

Statement 

24.3 

WINCHR 

1/0 Statement 

24.4 

V'INPUT 

I/O Function 

24.5 

WRITE# 

I/O Function 


Prints spaces 

Returns square root of its argument 
Returns target string array position 
Terminates program execution 
Returns string equivalent of a 
numerical argument 
Returns string of characters 
Exchange contents of two variables 

Formats Print output 
Returns tangent of argument 
Returns current time string 
Turns trace on/off 

Returns numeric value of string 
Returns address of variable 

Defines wand decode software 
Conditional execution of statements 
Inputs a single character from an 
optical wand 

Inputs string from optical wand 
Write data to file 
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ABS 


.2.1 Function ABS(N) returns the absolute value of the argument. 


Syntax ABS(N) where N can be a variable, number or result of a 
numeric expression. 


Examples Y=ABS(-12.345) returns Y=12.345 
Y=ABS(-0.5) returns Y = 0.5 
Y=ABS(0.5) returns Y=0.5 

or if V=-27 

Y=ABS(V) returns Y=27 
Y=ABS(V-50) returns Y=77 


Remarks The absolute value returned is always positive. 
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ARG 


5.2.2 Function ARG is used for passing parameters to machine code subroutines. 

Syntax D=ARG(N) 

Where D is a Dummy Variable 

N is the number to be passed 


Examples P=ARG(10) Passes 10 
P=ARG(V) Passes V 


Remarks ARG loads the Z80 E and C registers. 

They are loaded with the higher and lower byte portions of 
a 16 bit representation of the ARG argument. 

For example if V in the example above was 4100 then: 

E=16 C=4 

NOTE: 16x256+4 =4100 

This function is useful when making CP/M system calls to 
set the C register before a call to location 5. See 
section 4.8, MACHINE CODE CALLS. 
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ASC 


5.2.3 Function ASC returns the decimal ASCII value of the first character 
of a string variable. For a list of ASCII codes used with 
HUNTER Basic see section 9.2. 


Syntax ASC("STRING") 


Examples Y=ASC(X$(3)) 

PRINT ASCO'A") 

will print 65 

10 T$="AB" 

20 PRINT ASC(T$) 

will also print 65, since "A" is the first character. 


Remarks The string argument must be enclosed in parentheses. 

ASC is particularly useful for detecting special characters 
like control codes, and/or distinguishing them from digits 
0-9 or characters A-Z. 
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ATN 


5.2.4 Function ATN generates the angle whose tangent is specified by the 
argument. 

Syntax ATN(N) 

Exanples A=ATN(0.6009) 

Sets A equal to 0.541071 Radians, i.e. 31° 
or 

B=ATN(V) 

sets B equal to ARCTAN of variable V 

Remarks The resultant angle is specified in radians. 

To convert to degrees: 

A=ATN(V)*180/PI 

in the example above, 

PRINT (ATN(0.6009)*360/(2*PI)) 
returns 

31.0011 
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BEEP 


.3.1 Function BEEP sounds the internal sound generator. 
Syntax BEEP 

Example 10 FOR I = 1 TO 100 
20 BEEP:NEXT I 


Remarks This function is equivalent to OPCHR 7 and produces a short 
tone from the sound generator. For a more varied sound use 
SOUND. 
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CALL 


5.4.1 Function CALL allows a machine code subroutine or an existing 
routine in HUNTER'S housekeeping package to be called from 
Basic and executed. 


Syntax D=CALL(N) 

where D is a variable 

N is a Call Address 


Examples 10 A=CALL(0) 

20 B=CALL(V) where V is the address to be called 

Switches execution to the program located at the location 
specified. The call in line 10 causes a restart of the 
HUNTER'S software. 


Remarks WARNING: Use CALL only as indicated in section 4.8, MACHINE 
CODE CALLS. Use of unspecified calls will crash HUNTER, 
resulting in loss of data, etc. 

When control has passed back to Basic from a machine code 
program, then D = the final number stored in the Z80 
accumulator when the program returns. 
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CHAR 


5.4.2 Function CHAR specifies the character set. 

Syntax CHAR n[,I] 0<n<4 

Examples CHAR 2,1 

This will output double width text in inverse video if I>0. 

Remarks In graphics mode only there are five different character 
sets, with CHAR 0 being the default set. 

I is the inverse parameter. If it is zero then the 
characters are normal. If it is non zero then inverse video 
is displayed. 

CHAR 0 produces a small 7x5 pixel character set 
defaulted to after a SCREEN 1 statement. 

CHAR 1 is the standard 9x7 character set. 

CHAR 2 are double width characters. 

CHAR 3 are double height characters. 

CHAR 4 are double height and double width characters. 

N.B. Each time character size is changed, the cursor is 
re-located to the upper left-hand comer. 

NOTE: CHAR has no effect in text mode. 
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CHR$ 


5.4.3 Function CHR$ performs the inverse of ASC. It returns the single 
character string specified by the value of N, which may be 
an expression. 


Syntax CHR$(N) 

where the result of N is between 0 and 255. 


Examples 10 DIM A$(10,10) 

20 A$ = CHR$(34):REM (see note below) 

30 PRINT "HE SAID,"; A$;"HELLO";A$ 

40 B=7 

50 PRINT CHR$(B):REM BEEP 

60 PRINT CHR$(1):REM THIS CLEARS THE SCREEN 

The above will print: 

HE SAID, "HELLO" 

then bleep, and then clear the screen. 


Remarks The expression must have the value 0 to 255. The 
expression must be enclosed in parentheses. 

NOTE: (The character " cannot be embedded in PRINT strings since 

it acts as a delimiter). 
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5.4.4 Function 


Syntax 


Example 


Remarks 


CIRCLE 


CIRCLE draws a circle of given radius at the specified co¬ 
ordinates. 


CIRCLE [(X,Y,)] ,r[,n] 0<X<239 

0<Y<63 


10 FOR I = 20 TO 220 STEP 40 
20 CIRCLE (1,32),20 
30 NEXT 


Will plot six circles across the display. 


The optional parameter n will plot the circle in black if 
it is odd, or erase the points if it is even. When 
omitted, it defaults to odd. The co-ordinates may also be 
omitted, and the circle is.then centred on the current 
graphic cursor position. Circles plotted off the edge of 
the screen will produce wrap around, Modulo 256. 

The CIRCLE command range checks the x-coordinate, y- 
coordinate and radius to be less than 256. Since the 
HUNTER screen in graphics mode can only display 0-239 and 
0-63 in the x and y directions respectively, there are 
occasions when the expected circle does not appear on the 
screen. 


VER.V09F 


PAGE 5-13 



BASIC FUNCTIONS 


SECTION 5.4 


CLEAR 


.4.5 Function CLEAR will set all variables defined in the applications 
program to zero. 

Syntax CLEAR 

Examples CLEAR 

resets all variables. 


Remarks Note that the variables are also set to zero if at any time 
program lines are altered or added. Variable contents are 
otherwise maintained indefinitely by HUNTER, as described 
earlier. Clear also resets the FOR/NEXT loop stack and 
arithmetic stack. 
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CLOSE# 


5.4.6 Function CLOSE# will close any file that has been OPENed. 


Syntax CLOSE[#file 1,#file 2.//file X] 

Examples CL0SE//4, #5 

Will close file numbers 4 and 5. 


Remarks If CLOSE is specified with no parameters all files that 
have been OPENed are CLOSEd. 

When the CLOSE command is executed, HUNTER'S firmware 
automatically performs a checksum generation on the file 
and stores the value in the file directory for checking the 
next time the file is opened. 

Failure to CLOSE the file in the correct manner will result 
in a 'no file' error message when an attempt is made to 
OPEN the file at a later date. 

When a file is closed, any data in the buffer not already 
written to the file will be saved. This means that there 
must be space available in the HUNTER for a file to be 
closed correctly. It is therefore recommended that the 
following method be used to ensure data integrity in all 
application programs where the above problem may arise. 

10 OPEN "EXPAN.DTA»F0R OUTPUT AS 1 
20 WRITE //# 1 ,A:CL0SE 

This reserves an area of memory in the disk space. Using 
0NERR0R to trap a "disk full" error, the handling routine 
could simply be: 

1000 KILL"EXPAN.DTA" 

1010 CLOSE 

This ensures that there will always be enough room to close 
all files. 
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CLS 


.4.7 Function CLS clears the display screen. 


Syntax CLS 
Example 100 CLS 

This clears the screen ready for text or graphics output. 


Remarks In either graphics or text mode, CLS will clear the LCD 
display. It has a similar effect to OPCHR 1, Ip graphics 
mode, the screen may also be cleared ( and the character 
set initialised to CHAR 0) with SCREEN 1. 

NOTE: Only the screen mode currently in use (text or 
graphics) is cleared when CLS is used. 
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.4.8 Function 


Syntax 


Example 


Remarks 


COM 


COM activates or deactivates the communications interrupt 
routine. 


COM ON 
COM OFF 
COM STOP 

These statements must be initialised with an ON COM 
statement. 


10 ON COM GOSUB 1000 
20 COM ON 

1000 REM TRAP ROUTINE 
1010 LINPUT A$ .,. 

1990 RETURN 


These statements decide what action is taken on receiving 
communications. The interrupt occurs on the first 
character. 

COM ON When executed, allows trapping of communications 
by the ON COM statement. If the previous state 
was COM OFF then the buffer is cleared by this 
statement. 

CCM OFF The trapping is deactivated and all 
communications interrupts are ignored. 

COM STOP Communications interrupts are noted but not acted 
upon by the ON COM statement until a COM ON is 
executed. 
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CONT 


5.4.9 Function CONT continues Basic program after STOP. 


Syntax CONT [Line number] 

'Line number' is optional and allows the program to 
continue from a different line number. 


Exaiqples CONT continue from next line 
or 

CONT 1000 continue from line 1000 


Remarks Allows a program to continue execution from the line 
following the occurrence of: 

a) detection of the break key 

b) execution of a 'STOP' statement 

c) execution of an 'END' statement 

d) detection of a syntax error 

By specifying a line number argument continuation can occur 
from that line number. 

In the case of multiple statement lines, execution will 
begin from the next line.. 
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COS 


.4.10 Function COS returns the Cosine of the argument. 

Syntax COS(Angle) 

Where angle is in radians. 

Examples X = COS(Y) sets X equal to the cosine of Y. 

R = C0S(5) sets R equal to the cosine of 5 radians. 

Remarks NOTE: For angles in degrees use: 

X=C0S(A/180*PI) 
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CRT 


5.4.11 Function CRT causes HUNTER to treat the serial port as the display 
and keyboard rather than the internal LCD display and 
keyboard. 


Syntax CRT 
Examples CRT 


Remarks CRT sets keyboard and display functions to the RS-232 port. 

The command is useful for entering programs quickly also 
characters not on HUNTER'S keyboard may be used. 

Any standard VDU may be used. Baud rates and other 
parameters are set on HUNTER using 'Initialise 
Communications'. 

Remember that a 'crossed' RS-232 lead is needed with 
GND,RXD and TXD circuits installed. 
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CUROFF/CURON 


5.4.12 Function CUROFF/CURON turns cursor off arid on. 

Syntax CUROFF 
CURON 

Example CUROFF 

To remove the cursor when display in use. 
CURON 

This will turn the cursor on. 

Remarks HUNTER defalts to CURON following power up. 
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DATA 


5.5.1 Function DATA statements hold constants for use in subsequent READ 
statements. 


Syntax DATA item 1, item 2., item n. 


Examples 100 DATA 12,A1,25,SIN(0.5),MID$(A$,3,4),99 
110 DATA 5,6,7,8,6*5,"HELLO" 

After reading the value 99 the READ will take 5, and so on, 
until every data value is used. This form of data storage 
is not affected by CLEAR or program line changes which will 
erase variables. To return to the first value in a DATA 
list use the RESTORE statement. 

A data statement must appear on a program line by itself. 
It cannot form part of a multiple statement. 


Remark The arguments for DATA statements can be either numerical 
values, variables, or expressions. Multiple arguments are 
separated by commas. 

String variables may be used in DATA statements. Direct 
text must be enclosed in quotes. 

NOTE: Care must be taken that variables in the 
corresponding READ statement are of the same type as the 
DATA. 
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DATE$ 


2 Function DATE$ returns a ten character string including the day, 
month and year separated by dashes. It may be used both as 
a statement and a variable. 


Syntax A$ = DATE$ or DATE$ = B$ 


Example 10 DATE$ = "5/12/86" 
20 PRINT DATE$ 


Remarks The ten character string returned by DATES is in the format 
MM-DD-YYYY. As in the example, when DATES is used as a 
variable leading zeros may be omitted and the year 
defaulted to 19yy. 

DATES will accept /or : or - delimiters to set the date, 
but will always print the date using ~. 
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DAY$ 


.5.3 Function DAY$ returns a three character string, it may also be used 
for setting the correct day. 


Syntax DAY $ [="M0N M ] 


Examples DAY$="M0N" 

will set DAY $ to MON 
100 PRINT DAY $ 
will output: 

Mon 


Remarks The day string may be input in upper or lower case. 

Acceptable days are: 

MON 

TUE 

WED 

THU 

FRI 

SAT 

SUN 

DAY$ always outputs the day with one upper case character 
and two lower case. 
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5.5.^ Function 

Syntax 

Example 

Remarks 


DEFSEG 


DEFSEG defines the page of RAM addressed by subsequent 
CALL, PEEK or POKE commands. 


DEFSEG = page no. 
D£FSEG=1 

sets RAM page to 1 


DEFSEG may also be used as part of an expression 
PRINT DEFSEG*3 


Page no. is an expression from 0 to the last page in the 
system. When HUNTER is powered up, DEFSEG is set to 0. 
This is the TPA or workspace, most often used for machine 
code programs called from Basic. 

After a program error, DEFSEG is set back to 0. 
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DIM 


5.5.6 Function DIM allocates arrays within HUNTER. 

Syntax DIM variable name (array size) 

DIM double precision variable name (array size) 

DIM string variable name (array size, element size) 
where array size and element size are numeric expressions. 

Examples DIM A (25) 

defines an array variable A of 26 elements, including the 
element A(0). The array size must be positive. 

DIM J4(100),J5(100),Q(1000),J(N) 

defines multiple arrays. N is a previously defined variable. 


Remarks There are three kinds of DIM statement in HUNTER Basic : 
Simple variables, double precision variables and strings. 

NOTE: The maximum number of elements in a single array is 
16,384. 

All array types have a range from 0 (zero) to the limit 
defined in the DIM statement. 

Arrays can be allocated to any combination of variable 
names. 

Double precision arrays are defined in the same way except 
for the use of "1". Each element has a 14-digit size. 

DIM A!(25) 

DIM AZK32) 

define double precision arrays. 

Space for string arrays is reserved in HUNTER memory using 
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a DIM statement followed by string name, the number of 
elements in the array, and the maximum string length 
required. 

DIM A$(25,10) 

defines a string array with 25 elements each of maximum 
length of 10 characters. 

Each character in a string requires 1 byte of storage. 

Since HUNTER retains variable definitions indefinitely, DIM 
statements should not be included in normal user program 
sequences. Instead, arrays should be initialised by a 
separate routine or defined directly i.e. without line 
numbers. 

A useful technique is to set in the applicption software a 
switch indicating whether the program is being used for the 
first time or not. If the switch is a variable which is 
made non zero when the program is first run, the fact that 
any modifications or use of the CLEAR statement will clear 
the value to zero can be used to determine whether the 
arrays should be redefined or not. 

10 If A = 1 THEN GO TO 100 
20 DIM J(50) 


90 A = 1 

100 REM user program starts here. 

NOTE: That the variable A could be used as a counter to 
indicate the number of times that the program has been run. 

Default values for numeric arrays are 10 elements. Strings 
default to one element of 20 characters, larger strings 
have to be dimensioned. 
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5.6.1 Function 
Syntax 
Examples 


Remarks 



EDIT invokes the Hunter text editor. 


EDIT [filename] 


EDIT 

The editor is invoked. If a Basic program is currently 
loaded in the workspace, the editor will operate on it. If 
no program is loaded, entry of new text or program may 
proceed. 

EDIT "PR0G1" 

Program PR0G1.HBA is first loaded into the workspace. EDIT 
is then invoked. 


For full description of the editor see section 7, EDITOR. 

EDIT cannot be used as a program statement. 

To exit EDIT, either save the file (CTL/FN 6, followed by 
filename) or Exit (CTL/FN 8). The edited version of the 
program will remain in the workspace. 

NOTE: Following 'Save' or 'Exit’ commands, the editor will 
display a message: 

Wait 

A few seconds may elapse while the editor re-tokenises the 
Basic source text into the more compact format of the .HBA 
file. 

Only files with the .HBA suffix are treated in this way. 
When invoked from Basic, the editor assumes .HBA as a 
default suffix. 
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END 


5.6.2 Function END terminates user program execution. 

Syntax END 

Examples 1000 END 

when executed, displays: 

READY 

and returns control to the Basic command level. 

Remarks END does not require an argument. 

This is normally the last line of a program although Basic 
will default an END even if it does not exist. END may 
also be used ir- the middle of programs for terminating it. 

Generally user programs do not END but retain control over 
HUNTER operation. 
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EOF 


5.6.3 Function EOF checks for end of file. 


Syntax £0F(file no) 


Examples 10 OPEN "DATA.TXT" FOR INPUT AS #1 
20 INPUT//1 ,A,B,C 
30 PRINT A,B,C 

40 IF E0F(1)THEN CLOSE #1 ELSE GOTO 20 
50 PRINT"END OF FILE”:END 


Remarks EOF = -1 if end of file has been reached 
EOF = 0 if more data is in the file 

Programs should not try to read beyond the end of a file 
since an error will occur. 

NOTE: The file DATA.TXT used in this example, could be 
created by a Basic program of the form: 

100 OPEN "DATA.TXT"FOR OUTPUT AS #1 
110 WRITE/M ,123,235,345 
120 CL0SE/)1 
130 END 

This will ensure that the correct end of file marker is 
written to the file. 
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5.6.4 Function ERR and ERL return the error code and the line number at 
which the error occurred respectively. 


Syntax X = ERR Y = ERL 


Example 

10 GOTO 50 
20 A = ERR 

30 PRINT "Error Number";A;"at line";ERL 
50 ON ERROR GOTO 20 
60 B=A/0 
70 STOP 

This example prints: 

Error Number 6 at line 60 

due to the floating point error caused by an attempt to 
divide by zero. 


Remarks ERR and ERL will always contain the codes of the last 
error, and will often be used in conjunction with ERROR. 

These functions are often used in communications with the 
ON ERROR GOTO trap. 

NOTE: See section 4.14 for actual error numbers. 

ERR defaults to zero until an error occurs. 
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5.6.5 Function 


Syntax 


Example 


Remarks 


ERROR 


ERROR simulates a Basic error with the advantage that it 
allows user defined codes. For a list of Bsic error 
messages, see section 4.14. 


ERROR n 
where 0<n<255 


10 INPUTa.b 
20 ONERRORGOTOI00 
30 IFa>bTHENERROR156 
40 GOTOIO 

100 IFERR = 156THENPRINT"a>b error" 

110 RESUME 10 

The ERROR statement neatly traps errors and forces the 
printing of a Basic error message. If the error number is 
undefined in Basic, then processing can be forced to 
restart at another line to print a user defined message. 
When ERROR is set to n, this number may be recovered with 
ERR, and the line number with ERL. 

After a forced user error trap, a suitable RESUME command 
must be executed to ensure correct program operation. 
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EXP 


5.6.6 Function EXP generates the value of e raised to the power of X. 

Syntax EXP(X) 

Examples A!(0)=EXP(3) 

(A!(0)=e to the third power) 

B=EXP(N) 

(B=e to the power of N) 

Remarks X must be in the range -290 to +290. 

If X is not in this range then a 'MAG Error' will occur. 
X may be an expression, 
e is defined as: 2.7182818284590 
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5.7.1 Function FILES displays all the current user files in HUNTER. 


Syntax FILES 


Example This program will list all the current user files in 
HUNTER: 

6030 CLS:PRINT"PIease enter the file you wish to select:" 
6040 LOCATED,1:PRINT"(Use shift arrow keys to scroll)" 

6050 b0CATE0,3:FILES 

6060 IjOCATEO, 2:INPUT"enter filename ";a$ 
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5.7.2 Function FIX reduces the argument to an integer. 


Syntax A=FIX(n) 


Examples A=FIX(12.37) 
sets A = 12 

A=FIX(-5.95) 
sets A=-5 


Remarks FIX should not be confused with INT which will round 
negative numbers. 
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FOR 


5.7.3 Function FOR executes a series of instructions in a loop a given 
number of times. 


Syntax FOR N = A TO B STEP C 
NEXT N 

Where N is a variable, A is a numeric start value, B is a 
numeric end value and C is an increment/decrement value. 

A, B and C can be numbers, variables or expressions. 
Examples 10 FOR A = 1 TO 100 STEP 10 


100 NEXT A 

causes the value of A to equal 1,11,21 etc., for each 
execution of the loop. 

To obtain a decrementing count negative values of STEP are 
used. 

1000 FOR Z1 = 91 TO 10 STEP -.1 


1050 NEXT Z1 


Remarks When followed by a NEXT statement, FOR will execute the 
intervening parameters for the number of times indicated by 
the values A and B divided by N to the formula: 

(B-A+2)/N 

When terminating FOR...NEXT loops it is important to end 
using NEXT and not GOTO. Alternatively, exiting via a 
RETURN when in a subroutine will not cause a build up of 
the 'control stack'. 

Failure to do this will result in a control stack error. 
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FRE 


5.7.4 Function FRE returns the number of free bytes left in execution 
memory (RO). 


Syntax FRE(O) 

0 is a dummy argument. 


Examples PRINT FRE(O) 

displays amount of free space in execution memory, 
or 

A=FRE(0) 

Sets A = amount of free space. 


Remarks Note that if a program has not been RUN then the variables 
will not have been assigned space. This enables easy 
display of program size and, after RUNing, the total memory 
usage. 

The latter examples allows the AUTO SIZING of arrays to 
their maximum size. 

e.g. DIM A((FRE(0)-10240)/5) 

This autosizes A leaving 10K (10240 byte) for other 
variables. "5" is the number of bytes used for each member 
of A. Remember to leave enough space for all simple 
variables. 
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GOSUB 


5.8.1 Function GOSUB causes execution to jump to a Basic subroutine 
located elsewhere in the applications program. 

Syntax GOSUB line number 

GOSUB numeric expression 

Examples GOSUB 150 

causes program execution to jump to a subroutine located at 
150. 

The argument can also be an argument or expression, for 
example: 

GOSUB SI 

or 

GOSUB SI+100 S A 


This is illustrated by the program sequence: 

10 INPUT A 
20 SI=1000 
30 GOSUB SI+100*A 
40 STOP 

1000 PRINT "THIS IS SUBROUTINE 1" 

1010 RETURN 

1100 PRINT "THIS IS SUBROUTINE 2" 

1110 RETURN 
etc. 

If the number 0 is entered in line 10, the program will 
perform subroutine 1. Input of the number 1 will cause 
subroutine 2 to be executed. 


Remarks A subroutine must always be terminated by a 'RETURN' state 
ment. Program execution then continues from the statement 
immediately after the GOSUB. GOSUB always requires a line 
number as an argument. 
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GOTO 


5.8.2 Function GOTO branches unconditionally to a specified line number. 

Syntax GOTO line number 

GOTO numeric expression 


Examples GOTO 50 

causes program execution to commence immediately at line 
50. 


10 GOTO 100 

causes program execution to skip from line 10 to line 100. 

The line number may also be a variable or an expression. 
Examples: 

GOTO A or GOTO A*100 

are equally valid. 

The program sequence: 

20 ZB=150 
30 GOTO ZB 

150 PRINT "THIS IS LINE";ZB 
would give: THIS IS LINE 150 


Remarks GOTO is always used with an argument (line number). If 
used as an immediate command, GOTO will cause program 
execution to commence from the line number specified. If 
used as part of a program, GOTO will cause program 
execution to skip to the line number specified. If the 
line specified is not present in memory HUNTER will 
display: 

*LNo Error in line 150* 

If the GOTO line was unnumbered, the error message line 
number will be meaningless. 
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HELP 


5.9.1 Function HELP displays lines of text on HUNTER'S screen when the 
HELP key is pressed. 


Syntax HELP line number 

HELP numeric expression 


Examples 1010 REM THIS IS A PIECE OF HELP TEXT 

1020 REM INTENDED TO ASSIST THE OPERATOR 
1030 REM IN THE USE OF HUNTER 
1040 REM PLEASE PRESS HELP TO RETURN 
1050 REM TO PROGRAM 

10000 HELP 1010 

Execution of line 10000 will cause the block of remarks to 
be used as the HELP text. 

Remarks HELP requires an argument which must be a valid line 
number. The referenced line must be a REM statement. When 
the operator presses HELP, text from the referenced REM is 
placed on the screen. Use of the cursor up and cursor 
down keys causes scrolling through a contiguous block of 
REM statements. The HELP text start may be changed by 
executing another HELP statement. 

Normally, the help key on the HUNTER keyboard is disabled. 
Execution of HELP causes the HELP code to be loaded into 
the keyboard table, therefore enabling the use of the key. 
Once the HELP statement has been executed, it is not 
possible to disable the HELP function except for deleting 
the HELP code in the keyboard map. 

NOTE: On power up the help key will be again disabled and 
therefore it is necessary to execute the HELP statement 
within the program initialisation. 

It is recommended that all the HELP text be written con¬ 
tiguously so that the operator may scroll through all of 
it. Scrolling stops when any non-REM line is encountered, 
so blocks of text can be easily partitioned if required. 

NOTE: HELP text cannot be displayed if HUNTER is in 
graphics mode and operation of the HELP key is ignored. It 
is then necessary to use "shift FWR" to turn off HUNTER. 
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5.10.1 Function IF selectively executes program statements dependant on 
result of an expression. 


Syntax IF A(op)B THEN C 

Where A is an expression, variable or constant and (op) is 
an operator =, < , > etc. The operator may be logical or 
omitted. See section 4.2.3, LOGICAL OPERATIONS, for 
further details. 

B is an expression, variable or constant 
C is either a line number or program statement. 


Examples IF A = B THEN 100 

IF A>B THEN PRINT "NO" 

C may be a multiple statement which will be entirely 
executed if the condition is true, but skipped if not. 

HUNTER also permits nesting of IF statements. 

Example: 

IF A= B THEN IF C=D THEN PRINT "FINISHED":G0T0 1000 

String expressions may be tested for equality or 
unequality, for example: 

IF A$ + B£ = "ABCDEAB" THEN 100 

or 

IF A=B AND B=C OR D=5 THEN PRINT"TRUE" 

In this example "TRUE" may be printed by one of two methods 
allowed by the OR operator as follows: 

1) if A=B=C 

2) if D=5 
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However, 

IF A=B AND B=C AND D=5 THEN PRINF'TRUE" 

will only print "TRUE" if all conditions are satisfied. 

IF A THEN PRINT"TRUE" 

will print "TRUE" only if the variable A is non-zero, i.e. 
if A=—19 then "TRUE" will be printed. 

See section 4.2.2, EXPRESSIONS AND OPERATORS, and 4.2.3, 
LOGICAL OPERATIONS, for precise details of logical 
operators. 


Remarks For strings of unequal length the equality will be true if 
the string on the left of the equates is equal to or part 
of the string on the right as follows: 

IF A$ _ "ABC" and B$ = "ABCD" 

THEN 

A$ = B$ is true 
B$ = A$ is not true 
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IF..THEN..ELSE 


5.10.2 Function IF. ..THEN...ELSE... executes either of two 
statements as the result of an expression. 


Syntax IF (expression) THEN (statementl) [ELSE (statement) 2] 


Examples IF A=B THEN X=10 ELSE A=A+1 

IF D AND NOT B THEN C=0:G0T050 ELSE RETURN 

Multiple statements separated with colons are implemented 
or skipped depending on the condition. 

IF A=6 THEN IF B>10 THEN A=0 ELSE ELSE A=A+1 

Omitting the first ELSE will move processing straight onto 
the next line if the first condition is false (ie A=6) and 
cause A to be incremented if A=6 and B>10. 


Remarks The expression must be able to be evaluated true or false. 

If the expression is true then statement 1 is executed, and 
if false statement 2 is executed. 

The statement may include other conditional statements 
(nested), but care must be exercised in the positioning of 
ELSE to associate them with the correct IF. Generally, 
each ELSE is associated with the most recent IF.' Extra 
ELSE statements causing no action at the end of the line 
may be omitted. 

The use of logical operators outlined in the section 
relating to 'IF' are also allowed when using 
IF...THEN...ELSE. 
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5.10.3 Function 
Syntax 

Examples 


Remarks 


INCHR 


INCHR inputs a single character from the keyboard. 


INCHR variable name 

INCHR["PROMT STRING";] variable name 


10 INCHR "DECIMAL VALUE";A 
20 PRINT A 
30 GOTO 10 


displays: 

DECIMAL VALUE ?A 65 
DECIMAL VALUE ?B 66 
etc. 


INCHR does not wait for ENTER to be pressed. A prompt 
message is displayed as with INPUT. Only one variable may 
be entered. The variable is set to the decimal value of the 
character, as detailed in section 9.2, ASCII CHARACTER SET. 

A comma following INCHR or the prompt message will suppress 
the prompt character '?' The comma replaces the semicolon 
in the syntax. 

NOTE: No values are returned for SHIFT, HELP, CONTROL or 
POWER keys, although these function normally during INCHR. 

'Escape' cannot be used to return to Basic from an INCHR 
loop, since it simply returns the value 27! 


VER.V09F 


PAGE 5-45 



BASIC FUNCTIONS 


SECTION 5.10 


INKEY 


5.10.4 Function INKEY checks the keyboard for the operation of a key. 

Syntax INKEY A 

Examples INKEY A = 65 THEN STOP 

detects capital A and stops. 


Remarks The variable A is attributed the value of the key pressed. 

If no key is detected then the variable is equal to zero. 

INKEY does not wait for a key to be pressed; execution 
continues immediately at the next statement. 

INKEY is the faster method for obtaining the keyboard 
status. 
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5.10.5 Function INKEY$ reads the keyboard and returns a single character if 
an input is pending on the keyboard. 


Syntax A$ = INKF.Y$ 


Example 10 A$ = INKEY$ 

20 IF A$ = THEN 40 
30 PRINT A$ 

40 GOTO 10 


Remarks If a key has not been pressed then a null string is 
returned. The ASCII code of each key, including control 
codes, is read and assigned to the one character string 
variable A$. 

The characters entered into the program In this manner are 
not displayed on the screen unless explicitly printed (line 
30 in the example). One application may be to insert a 
pause in a program before displaying another screen of 
information: 

80 PRINT"last line of last screen" 

90 A$=INKEY$: IF A$="" then 90 
100 PRINT"First line of next screen" 

If a function key is pressed then a two character string is 
returned consisting of the ,/ ' 1 character and the number of 
the key pressed i.e. Pressing Function Key 1 will return 
the string " / '1" to an INKEY $ function. 
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INP 


5.10.6 Function INP inputs a byte from the designated port. 


Syntax INP(PORT) 

where PORT is a numeric Port Number. 


Examples A = INP( 132) 


Remarks Refer to section 9.8, PORT ALLOCATIONS, for details of 
addresses and functions, 

NOTE: A 'port' is a term used at the hardware level of 
Hunter. It refers to the input/output addresses used by 
the NSC800. 
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5.10.7 


INPUT 


Function INPUT obtains a line of data from HUNTER'S keyboard 
Syntax INPUTf;3["prompt string”;] varl, var2, ...var n 
Examples INPUT A 

Inputs a numeric value from the keyboard and places it into 
the variable A. 

INPUT M Parameters";A,B,C$ 

Inputs the values of A, B, C$ with the prompt message: 
Parameters? 

A comma following the prompt string supresses the question 
mark prompt following the prompt string: 

INPUT"Parameters",A,B,C$ 

will' prompt: 

Parameters 

If no prompt message is required at all then the format 
entered is: 

INPUT"",A 

A semicolon prior to the prompt string will inhibit the 
echo of the users 'Carriage Return'. 

Remarks Note that input lines are always terminated by pressing the 
'ENTER' key. 

INPUT cannot be used as a direct statement. 
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NOTE: If INPUT'S argument is a simple variable and an 
invalid entry is made, INPUT will simply re-prompt 
without an error message. An example is: 

10 INPUT A 

The user types 'HELLO'. After 'ENTER', HUNTER re-prompts 
on the next line: 

? re-do from start 
? 

and awaits a numerical entry. 
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INPUT USING 


5.10.8 Function INPUT USING obtains a line of data from HUNTER'S keyboard 
and validates this data with a user defined mask. 


Syntax INPUT USING (validation string, [min,max]) prompt string, 
variable name. 

INPUT USING (validation string, [min,max,E]) variable name 
where min, max are numeric expressions and E is a special 
command. 


Examples INPUT USING ("A999",2,4)S$ 

Causes ? prompt 

A minimum of 2 characters must be entered up to a maximum 
of 4. 

The inputs are stored in string expression S$. The first 
entry must be a letter in the range A-Z, the remaining 
entries must be numbers in the range 0-9. 

INPUT USING ("A999",,4)S$ 

The same as above, but minimum defaults to 1. 

INPUT USING ("A999",2,)S$ 

A minimum entry of 2 and maximum defaults to 95. Any 
entries after the fourth are validated against WILD. 

INPUT USING ("A999")S$ 

Minimum and maximum default to 1 and 95 respectively. 

INPUT USING (M$,3,6)S$ 

A minimum of 3 and up to a maximum of 6 entries are 
allowed. The entries are validated against the string 
expression M$. The user will receive a '?' prompt. 
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INPUT USING (M$,3,6)"ENTER",S$ 

Same as above, but with an 'ENTER' prompt. 

INPUT USING (M$,3,6,E)"F.NTER»,S$ 

Same as above, but after the 6th character has been entered 
HUNTER will assume that the enter key has been pressed. 

Remarks Entry fields can be made numeric, alphanumeric, etc., in 
flexible configurations. Entries that do not fit the mask 
are rejected with a bleep. 

INPUT USING is an extension of the standard INPUT state¬ 
ment. However, as each entry is made by the operator, the 
character is checked against the defined check string. A 
value which is out of range will cause an audible bleep to 
occur, rejecting the invalid entry. 

The input validation string consists of defined validation 
characters either in the form of a string expression e.g. 
A$,BN$ etc., or a direct string enclosed in quotations. 
Input validation string may NOT be omitted. 

The optional min and max expressions define the minimum 
number and maximum number of entries required. If neither 
min nor max are specified then default values of min 1 and 
max 95 are assumed. If maximum exceeds the number of 
characters in the input validation string, then the entries 
for which there are no validation characters are validated 
automatically with WILD card characters. If min=0 an input 
of 'CR' only is allowed. 

The values min and max can be variables or arithmetic 
expressions. Min must not exceed max or a syntax error will 
occur. Min must not be negative or a magnitude error will 
occur. Min and rnax must not exceed 95 or a syntax error 
will occur. 

'Enter' terminates entry. ' Enter' will not be accepted if 
the number of characters is less than minimum. 
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When the number of characters exceeds maximum no more 
characters will be accepted. A warning tone will sound. 
The cursor right and cursor left are available in INPUT 
USING fields to edit or correct data prior to pressing 
'ENTER'. 

The E parameter is optional. If it is specified then the 
'Enter' key does not have to be pressed to terminate the 
end of the characters allowed by the validation mask. 

CAUTION: If the input field extends over more than one 
HUNTER screen line confusing results may occur in subsequent 
attempts to delete or edit characters. 

To suppress the "?" prompt, a comma should follow the 
prompt string. There must be a prompt string when using 
comma, therefore, to have no prompt at all it is necessary 
to use the null string 

A string, enclosed by quotes, immediately following the 
validation expression will cause that string to act as the 
prompt. 

The cursor left and right keys are enabled in order to 
allow the user to modify incorrect entries by simply over¬ 
typing them. The delete key will delete the last character 
entered. 

VALIDATION CHARACTER TABLE 


A A-Z only 

B A-Z space 

C A-Z 0-9 

D A-Z 0-9 space 

N 0-9 + - . , 

9 0-9 only 

. Decimal point only 

* Wildcard 


NOTE 1: Wildcard allows a character in the range of space - del 
which includes all letters and numbers. 

NOTE 2: Control characters are not accepted. Other characters 
than those in the table will give a Syntax error when 
the statement is RUN. 
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5.10.9 Function INPUT# reads data from file. 

Syntax INPUT#file no,varl,var2,....varX 
Examples INPUT#1,A,B$,C$ 

This will input data to the variables A,B$ and C$ from file 
number 1. 


Remarks The variable specified in the INPUT statement should match 
the type of data stored in the file. 

The End of File function EOF should be checked to detect if 
the end of the data has been reached. See 5.6.3. for 
examples. 
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INSTR 


5.10.10 Function INSTR searches for the occurrence of one string in another, 
and returns with the position of the first match. 


Syntax Y = INSTR ([X]A$,B$) 1<X<255 


Example 10 A$= "BASICS" 

20 PRINT INSTR(A$,"S") 

This program will print 3, since this is the first 
occurrence of the letter S. 

10 A$ = "SUPER BASICS" 

20 B$ = "SI" 

30 PRINT INSTR(A$,B$) 

This program will print 9 as the first occurrence of SI. 

10 A$ = "BASICS" 

20 PRINT INSTR (4,A$,"S") 

The above program will print 6, since this is the first 
occurrence of the letter S from the fourth character on¬ 
wards in the string A$. 

Remarks If B$ does not occur in A$, then 0 is returned. X, which 
is optional and defaults to 1, is used to start the search 
at a particular place within a string. 

Case is also important, i.e. "s" is not the same as "S", 
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INT 


5.10.11 Function INT returns the truncated value of the argument, if 
positive, or rounds the value if negative. 


Syntax INT(N) 

Where N is a numeric expresion 


Examples A = INT(123.456) 

sets A equal to 123. 

Remarks NOTE: Negative numbers will be rounded in a negative 
direction. 

A=IMT(~4.75) 

Sets A equal to -5 

FIX is an alternative method. 
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JSR$ 


5.11.1 Function JSR$ creates a string of given length where the numeric 
argument is right justified and padded with leading zeroes. 

Syntax JSR$(A,N) 

A=Nurneric argument 
N=length 

Examples A = -12.34 

JSR$(A,8) returns -0012.34 
JSR$(A,5) returns -12.3 

A = 12.34 

JSR$(A,8) returns 00012.34 
JSR$(A,5) returns 012.3 

Remarks For positive numbers the '+' signs are replaced by 'O'. 

Sign (0 and -) and decimal point each count as one 
character. 
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KEY 


5.12.1 Function KEY enables/disables display of, and redefines soft key 
values. 


Syntax KEY ON 
KEY OFF 
KEY LIST 

KEYn,string 0<=n<=8 


Example KEY ON 

Allows the soft key display to be displayed on the bottom 
line of the display. This line is then not scrolled. 

KEY OFF 

Erases the soft key display from the bottom line of the 
screen, allowing this line to be used by the user. It does 
not inhibit the use of soft keys. 

KEY LIST 

This displays the entire string assignments of the eight 
soft keys on the screen. 

KEYn,string 

The keys are programmed by writing a string, of which the 
first four characters are displayed on the bottom line of 
the screen if the soft key display has been enabled, 

KEY1,"?X,Y" 

will set key 1 to print the values of the variables x and y 
when struck. Using the soft keys is equivalent to using 
the keyboard - but faster. 
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KEY 1, "?TIME$"+CHR$(13) 

will display the time when pressing soft key 1. 


REMA1KS On entering Basic, the soft keys default to: 


KEY 1: File(s) 
2: Run 
3: Edit 
4: List 


KEY 5: Save O') 
6: Load(") 
7: KilH") 
8: Syst(em) 


However, if the auto-run mode on power up has been 
selected, the soft keys are left as they were last 
programmed. 

When using the KEYn,string command, if KEYO is typed the 
soft keys revert to their power up default values. If n is 
not in the required range then a 'Magnitude Error' occurs. 

If it is required to terminate the string with a carriage 
return or Enter, then it is necessary to terminate with 
"string" +CHR$(13) as control characters are not accepted 
in command lines. 
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5.12.2 Function KEY(n) activates and terminates trapping of soft keys. 


Syntax KEY(n) ON 
KEY(n) OFF 
KEY(n) STOP 

n is a numeric expression in the range 1 to 8 to reference 
the soft key. 


Example 10 ON KEY (1) GOSUB 1000 
20 KEY (1) ON 


900 END 'FINISH OF MAIN ROUTINE 
1000 REM SOFT KEY (1) TRAP ROUTINE 
1990 RETURN 


Remarks The KEY(n) statement is used for trapping either soft key 
entries or cursor entries during program execution. It is 
initialised with the ON KEY (n) statement. 

KEY (n) ON, when executed, activates trapping of the keys. 
A GOSUB is automatically executed when a key is pressed to 
the line number specified in the ON KEY (n) statement. 

The display of the soft key function is not altered with 
this statement. 

If the same key is pressed again while the subroutine is 
being processed, then the interrupt is stored until the 
program returns from the interrupt routine when the GOSUB 
will be executed again. 

If a different key is pressed while one interrupt routine 
is being processed, then another GOSUB is immediately exe¬ 
cuted. Different key trapping routines may be nested, but 
each individual routine cannot be re-entered. 
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KEY (n) OFF The trapping routine is deactivated, and the 
key press is ignored. 

KEY (n) STOP Immediate execution of the trapping routine 
does riot take place, but the key is remembered and left 
pending until a KEY (n) ON statement is encountered. 
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KILL 


5.12.3 Function KILL deletes a file in RAM storage. 


Syntax KILL filename 


Example KILL "FIRST.HBA" 

Deletes FIRST.HBA 
KILL A$ 

Deletes the filename contained in A$ 


Remarks In order to KILL a file the filename must be given either 
explicitly or only using the "?" wildcard. Variable names 
are accepted, but must contain actual filenames. 

NOTE: If the file does not exist, then no action is taken 
and no warning message issued. 

If wildcards are used, then all files which conform to the 
format are erased, e.g, if H.1 and H.2 exist as files, 
then: 

KILL "H.?" 

will delete both of them. 
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5.13.1 Function LEFTS returns the first n characters from a designated 
string. Either string or n may be expressions. 


Syntax LEFT$("STRING",N) 

where string is a string expression M is the number of left 
most characters. 


Examples 10 A$ ="ABCDEFG" 

20 B$ = LEFT$(A$,3) 
30 PRINT B$ 

prints ABC. 


Remarks LEF1'$(A$,0) returns a Null String i.e. "" 
LEFT$(A$,50) returns ABCDEFG 

N cannot be negative or a "MAG" error will result. 
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LEN 


5.13.2 Function LEN returns the length of a string. 

Syntax LEN (string) 

where string is a string expression. 

Examples 10 A$ = "ABCDEFG" 

20 PRINT LEN (fl$) 

prints 7. 

Remarks The string may be an expression. 

A null string has zero length. 
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5*13.3 Function LET assigns a value to a variable. 


Syntax LET variable name = numerical expression 
LET string variable = string expression 


Examples LET C = 5 
LET D3 = B 
LET J = SIN(X) 

LET A$ = "HELLO" 

LET AS = B$ (see note) 

Use of LET in an assignment statement is optional. The 
formats: 

C = 5 
D3 = B 
J = SIN(X) 

A$ = "HELLO" 

A$ = B$ (see notes below) 
are equally acceptable. 


Remarks NOTE: When equating string arrays of unequal length the 
string array on the right side of the equates will be 
truncated on the left side. 

Example: 

DIM A$(1,5) 

A$= "HELLO" 

B$ = "GOODBYE" 

A$ = B$ 

then A$ = "GOODB" 

NOTE: Remember that string lengths default to 20 
characters. In the above example, A$ should be DIMed to 5 
character length as shown. 

Strings can be created by multiple additions. 

Example: 

A$ = A$ + MID$(C$,4,3)+CHR$(65) 
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String expressions can also be created from complex string 
expressions of up to 10 functions. The derivation of the 
function requires the creation of an expression stack which 
can handle a maximum of ten functions. If the stack is 
exceeded a 'string complexity' error will result. 

Example: 

A$ = LEFT$(RIGHT$(MID$(A$,3,N),A),B) 
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5.13.4 Function 
Syntax 

Examples 


Remarks 


LINCHR 


LINCHR inputs a single character from the RS-232 port. 


LINCHR variable name 

LINCHR ["PROMPT STRING";] VARIABLE NAME 


10 LINCHR "DECIMAL VALUE",A 
20 PRINT A 
?0 GOTO 10 


■displays: 


DECIMAL VALUE -65 
DECIMAL VALUE 66. 
etc. 


LINCHR does not wait for carriage return to be received and 
the character input is not echoed to the screen. A prompt 
message is displayed on the LCD screen as with INPUT. Only 
one variable will be received. The variable is set to the 
decimal value of the character, as detailed in section 9.2, 
ASCII CHARACTER SET. 

A comma following the prompt message will supress the 
prompt character '?'. 

Characters input from the serial port are not echoed onto 
the screen. 
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LINE 


5.13.5 Function LINE draws lines and boxes on the graphics screen. 

Syntax Line [(XI,Y1)] - (X2,Y2)[,P[,B[F]]] 0<X<239 

0<Y<63 

Examples 10 LINE (10,10) - (50,60) 

Draws a line from the co-ordinates (10,10) to (50,60) 


Remarks The parameter P is optional and if included denotes the 
colour of the line. If p is odd then the liner are drawn 
in black and if it is even then it is drawn in white (i.e. 
erased). P defaults to odd if omitted. 

The parameter B is used for drawing boxes with (XI,Y 1) and 
(X2,Y2) specifying the co-ordinates of the two diagonal 
comers. 

The F parameter is used to fill in the box with th 
specified colour P. The P parameter must be specified i 
either the B or BF is used. The following command will 
fill the graphics screen with a black filled in box: 

LINE(Q,0)-(239,63),1,BF 
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UNPUT 


5.13.6 Function LINPUT obtains a line of data from HUNTER'S RS-232 port. 


Syntax LINPUT [;]["prompt string";] variable name 
Examples LINPUT A 

Inputs from the serial port a numeric value and places it 
in variable A. 

LINPUT "PARAMETER VALUES" A,B,C 

Input the values of A, B and C with the prompt message: 

PARAMETER VALUES 
? 


Remarks Note that input lines are always terminated on reception of 
a carriage return (CR) character. 

LINPUT cannot be used as a direct statement, 

A prompt message can be displayed by the LINPUT statement. 
A string variable name or a literal string is required as 
an argument. Multiple variables can be strung together, 
separated by commas. 

The characters input from the serial input port are NOT 
echoed to the screen. 

A comma following the prompt message will suppress 
LINPUT's •?' prompt. 

NOTE: If LINPUT's argument is a simple variable and an 
invalid entry is made, LINPUT will simply re-prompt without 
an error message. An example is: 

10 LINPUT A 

HUNTER receives 'HELLO'. After 'CR', LINPUT generates a 
loud 'bleep' and re-prompts on the next line. 

NOTE: While the HUNTER is waiting for the first character 
to be received from the port, it will 'bleep' at 30 second 
intervals. 
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5.13.7 Function LIST causes HUNTER to list the program on the LCD screen* 


Syntax LIST [line no1][-line no2] 


Examples LIST 100- 

Lists from line 100 on the screen. If there is no line 100 
it will LIST from the next line in sequence. 


Remark LIST is optionally followed by a start line number and a 
finish line number, either of which may be omitted. If both 
are omitted the entire program will be listed. 
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5.13.3 Function LLIST causes HUNTER to list the Basic program to the 
serial port. 


Syntax LLIST [line no.1][-line no.2] 


Examples LLIST 100- 

will cause a listing to start at line 100 in the program. 


Remarks LLIST is optionally followed by a start line number and a 
finish line number, either of which may be omitted. If 
both are omitted, the entire program will be listed. 

LLIST can be terminated at any time by the escape ('ESC') 
key being depressed and held down until HUNTER responds 
with a confirmatory 'beep'. .Because a transmission buffer 
is used, up to 256 characters may remain for transmission 
after 'ESC' is confirmed. Power OFF will also abort a 
listing at any time without loss of stored data or program. 

It is advisable to check HUNTER'S Communication Parameters, 
see section 6.4, COMMUNICATION PORT SOFTWARE, before using 
LLIST for compatibility with the external device receiving 
the data. When a printer is being used, remember to check 
for baud rate and line feed requirements. Unless "Echo" is 
enabled in transmission parameter, there is no data echoed 
onto the screen. 

NOTE: Because the communications power supply is powered up 
by LLIST, a single high-to-low character will appear at the 
start of the record. Many systems will see this transition 
as a single, spurious, character. To avoid this problem, 
power up the interface first with either: 

LPRINT " " or OUT 132,1 

otherwise, it may be necessary to edit out this character 
on the host system. 
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5.13.9 Function LLOAD command allows the HUNTER to load Basic programs 
through its serial port. 


Syntax LLOAD 


Examples LLOAD 

Loads Basic source from the RS-232 port. 


Remarks Programs which were output using LLIST onto a storage 
medium, e.g, disk or another HUNTER may be reloaded using 
this command. LLOAD is terminated by typing ESC. See 
section 3.6, LOADING FILES, for a detailed description of 
program loading/unloading options. 

Be sure to check HUNTER'S receiving parameters for compati¬ 
bility with the device transmitting data. 

LLOAD data goes into memory via the Basic interpreter input 
routine and is syntax checked on the way - if errors or 
spurious data are found in the incoming data, HUNTER will 
stop loading and display: 

* SYX Error 

If this occurs at the start of a file, it is likely that 
some header data, not in Basic syntax, has caused the 
problem. 

Simply type LLOAD again, quickly, as HUNTER'S input buffer 
will still be receiving data. 

LLOAD does not echo incoming characters onto the screen. 
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5.13.10 Function 


Syntax 


Examples 


Remarks 



LN generates the NATURAL logarithm of X, i.e: logarithm 
to base e of X. 


LN(N) 

where N is a numeric expression. 

LN (8) 

generates the logarithm to base e of 8. (2.079441601991) 

If S=9.12 then: 

LN(S) 

generates the logarithm to base e of 9.12.(2.2104698042074) 
LN(—91) 

generates a 'Magnitude Error' and program execution will 
stop. 

X must be greater than zero. 

If X is negative or equal to zero then a 'Magnitude Error' 
will occur. 

X may be an expression. 
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LOAD 


5.13.11 Function LOAD reads a program into the Basic workspace from a 
file. 


Syntax LOAD filename [,R] 
Example LOAD "HUNTER.HBA" 


loads the Basic file, HUNTER.HBA into the workspace ready 
for execution. 

LOAD "HUNTER",R 

loads the Basic file HUNTER.HBA into the workspace and 
commences execution. 

LOAD "HUNTER.TXT" 

This loads an ASCII file into the Basic workspace. It 
processes the ASCII into Basic compressed format. 


Remarks For .HBA files, typing in the extension is optional. 
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5.13.1? Function 


LOC returns the number of records read/written to 
sequential file 


Syntax LOC(file no) 


Example 100 MAXFILES=2 

110 OPEN "TEST"FOR INPUT AS #2 
120 INPUT//2,A 

130 IF E0F(2)=0 THEN GOTO 120 
140 PRINT"End of File" 

150 PRINT"No. of records read = ";L0C(2) 

160 CLOSE#2 
170 END 

When the end of file has been reached the number of records 
that have been read will be displayed. 


Remarks The LOC(n) function can also be used to display the number 
of records written to a file. 

NOTE: the program to create the data file TEST could be of 
the form: 

10 OPEN "TEST" FOR OUTPUT AS/M 
20 FOR X=1 TO 100 
30 WRITE/M,X 
40 NEXT 
50 CLOSE/M 
60 END 

NOTE: A record consists of 128 bytes, so LOC gives a 
measure of the amount of file space used. 
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LOCATE 


5.13.13 Function LOCATE sets the text cursor on the screen. 
Syntax LOCATE x,y 


Maximum Value 


'Character Set 

| X 

1 

1 

1 

1 

y 


' Text mode 

i 79 

1 

1 

1 

23 

1 

j Char 0 

! 239 

1 

63 

1 

i Char 1 

1 30 

i 

5 


| Char 2 

1 30 


5 


i Char 3 

! 30 

1 

5 


! Char 4 

! 30 

1 

1 

1 

1 

t 

1 

5 

1 


Example 10 LOCATE 0,0 

Places the cursor in the top left-hand corner. 


Remarks LOCATE is most useful for locating the cursor before 
printing text onto the display. LOCATE operates 
differently in text mode and graphics mode. 

Text Mode: Addressing a location outside the current window 
will cause the window to move so that the new cursor 
position is visible. 

The maximum values for the parameters are X = 79 and Y = 
23, being the size of the virtual screen. 

Values greater than the maximum for X will cause wrap¬ 
around on the same line. Values greater than the maximum 
for Y will remain at the bottom of the screen. 

Graphics Mode: A SCREEN 1 command will reset the cursor to 
the origin at (0,0). When character set zero is selected 
the LOCATE co-ordinates are referenced to the graphics 
pixel position. Otherwise, the co-ordinates specified in 
LOCATE refer to the top left hand pixel of a 7 x 5 
character cell, the size of which is equivalent to a CHARI 
character. 
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5.13.14 Function 
Syntax 

Examples 


Remarks 


LOG 


LOG generates the logarithm to base 10 of X. 

LOG(N) 

where N is a numeric expression. 

LOG(32) 

generates the logarithm to base 10 of 32. 

If S=1.319 then: 

LOG(S) 

generates the logarithm to base 10 of 1.319. 

LOG(-6) 

generates a 'Magnitude Error' and programme execution will 
stop. 

X must be greater than zero. 

If X is negative or equal to zero then a 'Magnitude Error' 
will occur. 

X may be an expression. 
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5.13.15 Function LOPCHR outputs characters to the RS-232 port which have 
their ASCII values defined as decimal argument(s). 

Syntax LOPCHR numerical exprssion 1, numerical expression 2... 

Examples LOPCHR 61,62 displays => 


Remarks This permits computing of characters and also advanced 
functions such as cursor addressing. The argument should 
be 0 - 225. 
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LPRINT 


5.13.16 Function LPRINT outputs to the serial port. 

Syntax LPRINT expressions. 

Examples LPRINT A,B,C$ 

Outputs variables A,B and C$ to the serial output port. 

Remarks LPRINT is exactly equivalent to PRINT except that output 
goes to the serial RS-232 port and not the screen. 

See PRINT for a full description. 

LPRINT formats can be altered by the following statements: 
LPRINT % N % 

sets the number of decimal places equal to N, a number in 
the range 0-9. Rounding occurs up or down as appropriate. 

LPRINT % Z N % 

sets the number of trailing zeroes (or decimal places) 
equal to N, a number in the range 0-9. 

LPRINT % E % 

sets all following LPRINT formats to scientific notation. 
LPRINT % % 

restores LPRINT format to normal 
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5.13.17 Function 

LTRON turns on the trace but sends the trace output to the 
printer. 

Syntax 

LTRON 

Examples 

LTRON 

Remarks 

LTRON, terminated with TROFF, produces the same output as 
TRON but on an external printer. 

See TRON for a full description. 
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5.14.1 Function MAXFILES defines the maximum number of files that may be 
opened simultaneously. 

Syntax MAXFILES = n 

Examples MAXFILES = 4 

Sets the maximum number of files that may be opened 
simultaneously to four. 


Remars MAXFILES will perform a 'CLEAR' operation destroying all 
existing symbol table entries. It must therefore be 
defined at an early point in the program. 

MAXFILES may also be used for input, for example: 

100 PRINT"Maximum number of files to be opened = ";MAXFILES 

will display: 

Maximum number of files to be opened = 4 


If no MAXFILES has been specified a default value of one is 
taken. 

The maximum number of files that may be opened simultaneous¬ 
ly is 15. 
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5.14.2 Function MID$ returns a substring of given length starting at the 
given position. It may also be used as a statement. 


Syntax B$=MID$ (A$,X, [Y]) 
or 

MID$ (A$,X, [Y]) = C$ 

Examples 10 A$= "ABCDEFGH" 

20 PRINT MID$ (A$,3,4) 
Prints CDEF 


Remarks A$,X or Y may be expressions. If Y is omitted then all 
characters to the right of the Xth character are returned. 
In the above example: 

MID$ (A$,0,3) = 'ABC' 

MIDI (A$,20,5) = null string 
MIDI (A$,7) = >GH» 

When MIDI is used as a statement in the form: 

MID$(A$,X[,Y!)=C$ 

its sets the part of A$ starting at the Xth character with 
the substring C$. The optional parameter Y denotes the 
length of the part of A$ to be replaced and if omitted 
defaults to the length of C$. 
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NAME 


5.15.1 Function NAME renames a HUNTER file. 

Syntax NAME oldname AS newname 

Example NAME "VERSION 1 .HBA" AS "VERSION2.HBA" 

NAME A$ AS B$ 

Renames the file VERSION 1.HBA to VERSI0N2.HBA 

Remarks After the NAME command, only the filename is altered. 

Filenames can be up to eight characters long with a three 
character extension. 
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NEW 


5.15.2 Function NEW will re-initialise all HUNTER'S user memory and reset 
all program pointers. 


Syntax NEW 

Examples READY 
NEW 

Are you sure (Y/N)? Y 
54613 bytes available 
READY 


Remarks All program lines are erased! 

NEW should, therefore, not be used if several programs are 
to co-exist in the same HUNTER. 

Always use NEW before loading a new user program into 
HUNTER to ensure the maximum use of space. 

NEW replies with: 

Are you sure? (Y/N) 

If any response to the confirmation message other than YES 
(Y) is made, then the function is aborted and existing 
programs are not affected. 

Following the 'Y* response, NEW displays the number of free 
bytes available before returning to Basic. 

Filespace is not affected by 'NEW 1 . 
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NEXT 


5.15.3 Function NEXT is the last statement in a FOR.NEXT loop. 

Syntax NEXT [V] 

V is optional and is a variable name that corresponds to 
the original FOR statement. 

Examples NEXT I or NEXT 
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ON BREAK 


5.16.1 Function ON BREAK allows the user to interrupt processing by 
operation of the BRK (Break) key. 


Syntax ON BREAK GOTO [line] 
or 

ON BREAK OFF 

Examples ON BREAK GOTO 1000 
ON BREAK OFF 


Remarks This statement operates in a similar manner to the ON POWER 
statement, except that the break key is monitored instead 
of the power key. 
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ON COM 


5.16.2 Function ON COM defines a routine to be executed when data is re¬ 
ceived into the communications buffer. 


Syntax ON COM G05UB line number 


Example 10 ON COM GOSUD 100 
20 COM ON 


100 'SUBROUTINE TO READ 
110 'INCOMING DATA 


190 RETURN 


Remarks This statement is used in conjunction with the COM 
statement. It tells Basic where to jump to in the event of 
a communications interrupt. 

Data may be left in the communications buffer for as long 
as is necessary. 

On an interrupt an automatic COM STOP is executed so inter¬ 
rupts are never nested. The RETURN from the trap routine 
performs an automatic COM ON, so re-activating the inter¬ 
rupt routine, unless a COM OFF statement was executed 
before the RETURN. 
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5.16.3 Function ON COMMS allows communication errors (typically a protocol 
failure) to be handled by the user's application program. 


Syntax ON COMMS GOTO [line no] 
or 

ON COMMS OFF 


Examples ON COMMS GOTO 1000 
ON COMMS OFF 


Remarks The statement operates in a similar manner to ON POWER. 

When a communications error is detected, control is 
returned to the Basic interpreter. Execution continues from 
a defined line number specified in the Basic program. 

In order to allow normal communication error messages the 
statement ON COMMS OFF disables this mode. The byte of 
memory COMERR is available to the programmer and contains a 
code which represents the type of error which has occurred 
in the communications. The available codes and their 
meaning are described more fully in section 6.7.8, 
COMMUNICATION ERROR. 

In a typical application, ON COMMS would be used to present 
the Operator with a plain language statement of the form: 

"Communications have failed. Please re-dial and try 
again". 

Re-trys or repeat blocks can also be controlled by the user 
program, as required. 
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ON ERROR 


5.16.4 Function ON ERROR is used to catch errors which would normally give 
a Basic Error message. 


Syntax ON ERROR GOTO [line no] 
ON ERROR GOTO 0 


Examples 10 ON ERROR GOTO 1000 
20 INPUT A 
30 A = SQR(A) 

40 PRINT A 
50 GOTO 20 
1000 A =ABS(A) 

1010 PRINT "NEGATIVE NUMBER CORRECTED" 

1020 RESUME 30 

This example will trap negative numbers and correct the 
condition. 


Remarks ON ERROR causes program execution to be diverted to an 
error handling subroutine. 

Any error can be trapped. However, ON ERROR is 
normally used for correctable errors e.g. magnitude errors 
which could be caused by operator input etc. 

An ON ERROR trap must be exited by either an RESUME 
statement or by ON ERROR GOTO 0 which will give the normal 
Basic error message. 
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ON..GOSUB 


5.16.5 Function ON...GOSUB... allows conditional subroutine calls. 


Syntax ON expression GOSUB line number 1, line number 2.line 

number n. 


Examples 10 ON A GOSUB100,180 
20 PRINT "HELLO" 

If A=1 then program execution will go to line 100 and will 
then go to line 20 when a RETURN is encountered. 

If A=2 then program execution will go to line 180 and will 
then go to line 20 when a RETURN is encountered. 

10 B=100:C=300:D=350 
20 ON A GOSUB B,C,D 
30 PRINT "HELLO" 

If A=1 then program execution will go to line 100 and 
revert back to line 30 when a RETURN is encountered. 

If A=3 then program execution will go to line 350 and 
revert back to line 30 when a RETURN is encountered. 


Remarks ON GOSUB will cause program execution to go to a line 
number chosen from the list of line numbers positioned 
immediately after GOSUB. The selection of a particular 
line number in this list is determined by the value of 
[expression]. 

Once program execution has been forced to go to one of the 
selected line numbers, each statement following that line 
number will be executed in order until a RETURN is 
encountered. At this point program execution will revert 
back to the statement following the list of line numbers. 

The integer part of [expression] is used so that if A=2.9 
program execution will go to line 180 in the example. 
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NOTE: The value of [expression] is NOT rounded up. 

If the value of [expression] is zero or greater than the 
number of line numbers in the list, then program execution 
will continue with the next statement. 

In the above example, if A=3 then "HELLO" will be printed 

IMMEDIATELY. 

The maximum value of [expression] allowed is 255. 

If the value of [expression] is greater than 255 or 
negative then a 'Magnitude error' will occur. 

The line numbers in the list of line numbers may themselves 
be expressions. 
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ON..GOTO 


5.16.6 Function ON...GOTO... allows conditional jumping. 


Syntax ON expression GOTO line number 1, line number 2, ....line 
number n. 


Examples 10 ON A GOT0100,200,300 
20 END 

If A=1 then the program will go to line 100 

If A=2 then the program will go to line 200 

If A=3 then the program will go to line 300 

If A=1.3 then the program will go to line 100. 


Remarks ON GOTO will cause program execution to jump to a line 
number chosen from the list of line numbers positioned 
immediately after GOTO. The selection of a particular line 
number in this list is determined by the value of 
[expression]. 

The line numbers may themselves be expressions. 

The value of [expression], in the above example A, is 
truncated to an integer. 

It must be noted that the value is truncated to an integer 
and NOT rounded up. So if the above example A=1.9 then the 
program will go to line 100. 

If the value of [expression] is zero or greater than the 
number of line numbers in the list, then program execution 
will continue with the next statement. 

In the above example, if A=4, or if A=0 then the program 
will automatically go to line 20, and an END will be 
executed. 

The maximum value of [expression] allowed is 255. 

If the value of [expression] is greater than 255 then a 
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'Magnitude Error' will occur and program execution will 
stop. If in the above example A=256 then an error will 
occur. A 'Magnitude Error' will also occur if the value of 
[expression] is negative. 

Example: 

10 0NAG0T0 100,200,300:PRINT "HELLO" 

20 END 

If A>3 or A=0 then the program will not go to any of the 
lines but will immediately print "Hello", and then END will 
be executed. 
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ON KEY 


5.16.7 Function 


ON KEY specifies a routine to be executed when a soft key 
or cursor control key is pressed during program execution. 


Syntax ON KEY (n) GOSUB line number 


Examples ON KEY(1) GOSUB 5000 

If function key 1 is pressed the program will execute the 
subroutine located at line 5000. 

Remarks For a definition of n and details of using this function 
see the KEY (N) statement. Line number specifies the trap 
routine, which must be terminated with a RETURN. 
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5.16.8 Function 

Syntax 

Examples 

Remarks 


ON POWER 


ON POWER allows the programmer to trap and .vector program 
execution if a user presses the power off key. 

ON POWER GOTO [line no] 
or 

ON POWER OFF 

ON POWER GOTO 1000 


This statement causes the OFFVECT locations to be loaded 
with a vector so that if operation of the power down key is 
detected, program execution occurs from the line number 
specified. 

Operation of the break key, or a syntax error, will cause 
the vector to be re-initialised to enable the power on/off 
switch to function normally. 

ON POWER OFF 

This statement also re-initialises the OFFVECT location. 
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ON POWER RESUME 


5.16.9 Function ON POWER RESUME restarts program 


Syntax ON POWER RESUME 


Examples ON POWER RESUME 


Remarks After HUNTER has been switched off, either by the power off 
key or any other means, switching HUNTER on will restart 
the program from the point where it was switched off, even 
if input was in progress. 

Exit from ON POWER RESUME is made by holding down 'control 
and C* before pressing the power on key and entering the 
escape code, see section 3.8.4, Exiting 'CONT', for details 
of entering the escape code. 
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ON TIME$ 


5.16.10 Function ON TIME$ specifies a routine to be executed ata defined 
time. 


Syntax ON TIMES = A$ GOSUB line number 

A$ is a string defining the interrupt time 


Example 10 ON TIMES = ''12:00:00" GOSUB 1000 


Remarks The executing program will be interrupted at the specified 
time and execution will begin again in the subroutine 
beginning at 'line number'. 

The time is checked at the beginning of a new statement, 
therefore if Basic is waiting on an input, for example, the 
interrupt will not occur immediately. 

NOTE: ON TIMES is only effective when HUNTER is powered up. 
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OPCHR 


5.16.11 Function OPCHR outputs characters to the screen which have their 
ASCII values defined as decimal argument(s). 


Syntax OPCHR numerical exprssion 1, numerical expression 2... 


Examples OPCHR 61,62 displays => 
OPCHR1 clears the screen. 


Remarks This permits computing of characters and also advanced 
functions such as cursor addressing. The argument should 
be 0 - 255. Arguments greater than 255 will give an 
argument error. 

Cursor addressing: 

Example: OPCHR 15,5,3 

The argument 15 instructs HUNTER Basic to interpret the 
following two arguments as cursor co-ordinates x,y 
respectively. It must be noted that re-positioning the 
cursor in this manner will not cause the virtual screen 
window to be re-positioned over the relevant area of the 
virtual screen automatically. If automatic re-positioning 
is required then use LOCATE. 
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OPEN 


5.16.12 Function OPEN opens file for I/O 

OUTPUT 

Syntax OPEN "file name" FOR APPEND AS file no. 

INPUT 


Example 10 OPEN "OUTFIL.TXT" FOR OUTPUT AS 1 

This will open the file "OUTFIL.TXT" for output from a 
Basic program as file number one. 

or 10 OPEN "APPEND.TXT" FOR APPEND AS 3 

This opens the file "APPEND.TXT" as file number three. Any 
data written to the file will be appended. MAXFILES must 
have previously been set to a minimum of three. 

or 10 OPEN "INPUT.TXT" FOR INPUT AS 4 

The file is opened for input as file number four, this will 
allow the data in the file to be read by a Basic program. 


Remarks When a file is OPENed HUNTER'S firmware automatically 
performs a checksum generation on the file and compares it 
to a value stored in the file directory, when the file was 
last CLOSEd. Any inconsistency will result in a 'DSK 
ERROR' being returned to the user. 

The OPEN statement parameter FOR has three options 
OUTPUT,APPEND and INPUT, they perform the following 
functions: 

OUTPUT : This will open a file for output. Any data that 
is in the file will be lost. 

APPEND : This will also open a file for output, but any 
data that is output to the file will be added to the end of 
the data that is already present. 

INPUT : The file is opened for input. This will allow a 
Basic program to read data from the file. 

The file number cannot be greater than the number specified 
in MAXFILES. If MAXFILES 3 has been specified the file 
number cannot be greater than three. 
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OUT 


5.16.13 Function OUT outputs a byte of data to a specified port. 


Syntax OUT address, data 1, data 2....data n. 


Examples OUT 133,1 

Switches DTR to the off state. 


Remarks OUT is used to control internal HUNTER functions like power 
control. See section 9.8, PORT ALLOCATIONS, for details of 
port addresses. 
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PEEK 


5.17.1 Function PEEK fetches the value of a designated byte in HUNTER's 
memory. 

Syntax PEEK (ADDRESS) 

where ADDRESS is a numeric expression. 

Examples PRINT PEEK (17933) 

prints the value of location 17933 (in decimal) on the LCD 
screen. 


Remarks PEEK requires the decimal value of the required memory 
location as an argument. See also DEFSEG to set the page 
address. 
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5.17.2 Function PI is used to return the value of PI 
Syntax A = PI 

Example 10 INPUT "ANGLEIN DEGREES",A 
20 LET B = A*PI/180 
30 PRINT A;"DEGREES ARE";B;»RADIANS" 

This program will convert an angle in degrees to an angle 
in radians. 

Remarks PI is returned with 6 digit precision i.e. 

PI = 3.14159 
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Remarks 
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POINT 


POIHT returns the 'colour' of the specified pixel. 
A = POINT (X,Y) 


10 REM Invert the graphics screen 
20 FOR X = 0 TO 239 
30 FOR Y = 0 TO 63 

40 IF P0INT(X,Y) = 1 THEN PRESET (X,Y) ELSE PSET (X,Y) 
50 NEXT Y:NEXT X 


An odd number returned by the function indicates a black 
pixel, while an even number indicates a white pixel. If 
the co-ordinates are out of range then -1 is returned. 
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5.17.4 Function POKE allows the user to write to a specified location in 
HUNTER'S memory. 

Syntax POKE address, data 1, data 2,....data n. 

Examples POKE AD,1 

Pokes the value 1 into location AD. 

Variable AD contains the address to be POKEd. 

Remarks The data can be a variable or an expression and must be in 
the range 0-255. Values greater than 255 will give an 
argument error. See also DEFSEG to set the page address. 

WARNING Use POKE with care. 
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POP 


5-17.5 Function POP fetches (POP's) a value from the machine code sub¬ 
routine linkage stack. 

Syntax POP(N) 

where N=number of parameters to be POPPED. 

Examples A=P0P(2) 

POPs two values off the machine code’ linkage stack. 

A=latter parameter. 

Remarks Allows Basic to access 16 bit results from machine code 
subroutines. 

Refer to section 4.8, MACHINE CODE CALLS, which discusses 
machine code calls. 

WARNING do not attempt to pop more variables from the stack 
than have been pushed. 
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POS 


5.17.6 Function POS returns the current cursor position on the line. 

Syntax POS(n) n is a dummy argument. 

Examples A=P0S(X) 

Variable 'A' contains the current cursor column position. 
Remarks The'returned value will be in the range 1 to 80. 
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5.17.7 


POWERn 


Function POWER n auto power off period. 


Syntax POWER n 

n is in the range 10-255 and is the number of 5 second 
periods. 


Examples POWER 12 

will switch HUNTER off after 1 min. 
POWER 0 

will prevent timed switch off. 


Remarks POWER 0 will enable the power off key after POWER CONT has 
been executed. 

To remind the user that HUNTER has been left switched on, 
HUNTER will emit a bleep every 150 seconds. Power n is 
reset to the default value (n=60, or 5 minutes) after power 
off/on and should be re-initialised by the user's program. 
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POWER CONT 


5.17.8 Function POWER CONT disables the power off key and time outs. 


Syntax POWER CONT 
Examples POWER CONT 

This will disable the power off key and time outs. 

Remarks To enable the power off key and time outs use POWER n. 

Use of POWER CONT allows the user program control of the 
power key to force, for instance, completion of a data 
entry sequence before the unit can be powered down. 
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POWER OFF 


5.17.9 Function PCWER OFF switches HUNTER off 
Syntax POWER OFF 
Examples POWER OFF 


Remarks . After POWER 0FF, : has been executed switching HUNTER on will 
automatically run the program from the start. 

To exit from POWER OFF press 'Esc' and enter the code 
: 56580. 

Power off is used in applications where 'Cont filename' 
could give confusing results if the unit is left in an 
uncontrolled state by a previous user. 
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POWER OFF RESUME 


5.17.10 Function POWER OFF,RESUME switches HUNTER off. 


Syntax POWER OFF,RESUME 


Examples POWER OFF,RESUME 


Remarks After POWER OFF,RESUME has been executed switching HUNTER 
on will re-start the program from the next statement and 
restore the screen. 

Unlike POWER OFF, this function does not require the code 
56580 after 'Esc' in order to exit from the program. 
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PRINT 


5.17.11 Function PRIHT displays data on the LCD screen. 

Syntax PRINT expressions [;] 
or ? expressions 

The question mark is exactly equivalent to PRINT 
Example PRINT X,Y,Z$ 

Prints the values of the three variables X,Y, and Z$ in 
columns 1, 1*1, and 28 and finishes with CR/LF. A PRINT 
statement with no expressions just performs the CR/LF 
functions. 


Remarks The comma between the expressions move the print cursor to 
the next zone, where each zone is fourteen spaces wide. 
The use of semi-colons causes the values to be printed 
together without gaps. However, numerical data leaves a 
space at the start for the minus sign, and includes one 
blank space afterwards. A semi-colon at the end of the 
line suppresses the CR/LF. 

Examples: 

PRINT "FOOT 1 ' + "BALL" outputs FOOTBALL 
or 

PRINT X;"SQUARED IS"; outputs, if X=2 
PRINT X*X 2 SQUARED IS 4 


or 

IF A<2 THEN PRINT "A=»;A outputs, if A=1 

A=1 


or 

PRINT CHR$(1); will clear the LCD display. 


VER.V09F 


PAGE 5 - 111 



BASIC FUNCTIONS 


SECTION 5.17 



This page intentionally left blank. 



VER.V09F 


PAGE 5 - 112 



BASIC FUNCTIONS 


SECTION 5.17 


This page intentionally left blank 


VER.V09F 


PAGE 5 - 113 



BASIC FUNCTIONS 


SECTION 5.17 



5.17.13 Function PRINT# writes data to file. 

Syntax PRINT#file no,var1;var2;....varX 

Examples PRINT#4,A$;B4;D$ 
or 

PRINT#1 ,X;Y;Z 

The variables specified are written to the appropiate file 
number. 


Remarks Variables should be separated by semicolons and not commas. 

As PRINT# outputs to the file in the same way as it would 
to the screen, any spaces present if commas were used would 
also be written to the file. 

Care should be taken when writing string data to files as 
they should not contain any commas, semicolons, leading 
blanks, carriage returns or line feeds as they would be 
interpreted as delimiting characters. If it is necessary 
to include any delimiting characters in a string the 
variable name should be enclosed in double quotes by using 
CHR$(34). 

For example, if A$ = "T0M,DICK" and B$="HARRY". The 
statement: 

PRINT#2,A$;B$ 

would write the following to the file: 

TOM,DICKHARRY 
and the statement: 

INPUT#2,A$,B$ 

would input 'TOM' to A$ and 'DICKHARRY 1 to B$. 
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To separate the data correctly the following format should 
be used: 

PRINT02,CHR$(3H); A$;CHR$(34 );CHR$(3*1);B$;CHR$(34) 


This would write the following to the file: 

"TCM,DICK""HARRY" 

and the statement: 

INPUT#2,A$,B$ 

inputs 'TCM.DICK' to A$ and 'HARRY' to B$ 

The statement WRITEfln is a simpler way to perform the above 
functions. 
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5.17.1 1 * Function PSET and PRESET are used to set or reset an individual 
pixel at the specified coordinates. 


Syntax PSET (XI,Y1),(X2.Y2),(X3,Y3),... 

PRESET (XI,Y1), (X2,Y2),... 

Any number of points may be specified in one statement. 

(x,y) are the coordinates of the pixel to be set or reset 
and must lie in the range 0<x<239 and 0<y<63. The 
coordinate (0,0) refers to the top left corner of the 
screen. 


Examples PSET(0,0),(239,0),(0,63),(239,63) 

Will set the four corner pixels black. 


Remarks PSET and PRESET are graphic statements and wi]l default the 
screen to graphic mode. If when a PSET/PRESET statement is 
encountered the screen is in text mode, it will auto¬ 
matically change to graphic mode. 

PSET sets pixels (turns them black) 

PRESET resets pixels (turns them white) 

Each time a pixel is set or reset using PSET and PRESET the 
graphic cursor is moved to that pixel. 
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SECTION 5.17 


PUSH 


5.17.15 Function PUSH pushes a 16 bit value onto HUNTER'S machine code 
subroutine linkage stack which is generally used with 
machine code CALL'S. 


Syntax PUSH variable 1, variable 2 , ....variable n. 


Examples PUSH A,B 

pushes the integer (16 bit binary) representation of the 
variables A and B onto the stack. 


Remarks These variables may be accessed or modified by a machine 
code program. See section 4.8, MACHINE CODE CALLS. 

POP is the reverse of PUSH. 
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SECTION 5.19 


READ 


5.19.1 Function READ is used to input constants previously defined in a 
DATA statement. 


Syntax READ Variable 1, Variable 2, ...Variable n 


Examples READ X 

sets X equal to the current DATA constant. 

For example the program: 

10 DIM D!(10);DIM A$(10,10) 

20 DATA 3,5,2/3."HELLO" 

30 READ A,B,C,D!(0),A$(1) 

40 PRINT A;B;C;D!(0);A$(1) 

Prints: 

345 .66666666666667 HELLO 

with A,B,C equal to three sequential DATA constants, D!(0) 
a double precision constant and A$(1) a string expression. 


Remarks The constants are read sequentially until exhausted, when 
an error will result. The sequence may be restarted by 
using RESTORE. 

The variable type in READ must be the same as the 
corresponding DATA items: if not, a READ ERROR will occur. 
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5.19.2 Function 


Syntax 


Example 


Remarks 


VER.V09F. 
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SECTION 5.19 


REM 


REM denotes that the following text is a comment statement 
only. 


REM text 
or 

’ text 


1000 REM THIS ROUTINE CLEARS THE DISPLAY 
1010 REM 

1020 PRINT CHR$(1); 

1030 RETURN 


REM statements are ignored by the program. They can 
considerably improve readability but only at the expense of 
extra memory. Unnumbered REM statements can be used in 
host computer files which will be ignored when down loaded. 

The apostrophe may be used instead of 'REM 1 , but has an 
extra capability. When delimiting a comment after a Basic 
statement, the colon is unnecessary. 

10 X=X+1' THIS TYPE OF COMMENT SAVES MEMORY SPACE 

REM statements are also used as HELP source text. 
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SECTION 5.19 


RESTORE 


5.19.3 Function RESTORE is used with READ. RESTORE initialises the current 
DATA pointer to the first DATA statement in the program. 


Syntax RESTORE [line number] 


Example RESTORE 120 

This restores the data pointer to line 120. 


Remarks RESTORE may also be used with a line number argument. This 
will initialise further READ functions to a specified line. 
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SECTION 5.1,9 


RESUME 


5.19.4 Function RESUME restarts program execution at the specified point 
after an error. 

Syntax RESUME [NEXT] [line number] 


Example 10 ON ERROR GOTO 100 

20 IF A<B THEN ERROR 110 

it 

n 

it 

100 IF ERR>100 THEN RESUME L2+(ERR/10) 


Remarks If there is no argument in the statement then execution 
will begin again at the statement which caused the error. 

RESUME NEXT begins on the following statement and RESUME 
[line number] begins at the specified line. 
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SECTION 5.19 


RETURN 


5.19.5 Function RETURN from subroutine. 


Syntax RETURN 


Examples 10 GOSUB 100 

100 PRINT I 
200 RETURN 


Remarks RETURN is the logical conclusion of a GOSUB statement. 

Placed at the end of the subroutine, RETURN causes 
execution to continue at the next statement following the 
original GOSUB statement. 
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SECTION 5.19 


RIGHTS 


5.19.6 Function RIGHTS returns the last n characters of a given 
string. 

Syntax RIGHT$("STRING",N) 

where N is the number of rightmost characters to be 
returned. 

Examples RIGHT$("ABCDEF",3) 
returns DEF 


Remarks Both string and n must be enclosed in parentheses and can 
be expressions. If length of the string is less than n 
then the entire string is returned. 

If A$ = "ABCDEF" 

then: 

RICHT$(A$,0) = null string 
RIGHT$(A$,20) = ABCDEF 
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SECTION 5.19 


RND 


5.19.7 Function RND returns a 14-digit psuedo random number in the range 
0 - 0.99999999999999. 

Syntax RND(O) 

where "O" is a dummy argument. 

Examples A = RND(O) 

sets A equal to a random number. 

Remarks RND requires a dummy argument. 
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SECTION 5.19 


RUN 


5.19.8 Function RUN causes program execution to commence. 


Syntax RUN [line number] [numerical expression] [filename] 


Examples RUN 1000 

causes execution to commence from line 1000. 

Remarks RUN is useful when program de-bugging as it initialises the 
system stacks, GOTO does not. 

The line number may also be a variable or an expression, 
for example: 

RUN A- 
RUN A* 100 

or 

RUN "filename" 

causes the "filename" to be loaded and executed from the 
work area. 


RUN is a direct Basic command only. 
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SECTION 5.20 


SAVE 


5.20.1 Function SAVE writes a program into the file space. 


Syntax SAVE filename 


Example SAVE "HUNTER.HBA" 


Remarks The Basic program is written to the filespace in RAM. If a 
file already exists with the same filename, then the old 
file is overwritten. Filenames are up to eight characters 
long. The extension .HBA is automatically appended for a 
Basic program, if an alternative is not provided. 

An appropriate error message is displayed if there is 
insufficient file space for the program file. 
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BASIC FUNCTIONS 


SECTION 5.20 


SCREEN 


5.20.2 Function SCREEN changes the mode of operation of the LCD screen. 


Syntax SCREEN n 

n may be any numeric expression returning either a 0 or 1. 
Any other value will give a Magnitude Error. 


Example SCREEN A-A will put the screen into text mode. 

SCREEN 1 will put the screen in graphic mode. 


Remark TEXT MODE (SCREEN 0) 

This is the main mode of operation for the HUNTER. This 
mode is used to list Basic programs and to enter programs. 
In this mode the output is purely textual and gives a 
window of 8 lines of 40 characters on a virtual screen of 
24 lines of 80 characters. 

GRAPHIC MODE (SCREEN 1) 

In this mode the user is given much more control over the 
screen with high resolution graphics and up to 5 different 
types of character set. 

NOTE: Graphic commands set SCREEN 1 mode automatically. 
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SECTION 5.20 



5.20.3 Function SGN returns the value of the sign of the 
argument. 

Syntax SGN(N) 

where N is a numeric expression. 


Examples A = SGN(-9.5) 

sets A equal to -1 
A = SGN(0) 
sets A equal to 0 
A = SGN(1.76E9) 
sets A equal to 1 

Remarks Result: 

1 if Positive 
0 if Zero 
-1 if Negative 
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BASIC FUNCTIONS 


5.20.4 Function 
Syntax 

Examples 

Remarks 
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SECTION 5.20 



SIN returns Sine of the argument. 

SIN(N) 

where N is a numeric angle in radians. 

J = SINC2.56) 

sets J equal to the value of the sine of 2.56 
radians. 

PRINT SIN(2.56) gives: 

.549355436427 


The argument is expressed in radians. 
To convert to degress then: 

J = SIN(A/180*PI) 
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SECTION 5.20 


SOUND 


5.20.5 Function SOUND generates a note of a specified frequency and length. 


Syntax SOUND pitch,duration. 


Example SOUND 121,530 

This will produce a middle 'C' note for one second. 

The following program will play a short tune: 

10 FOR 1=1 TO 20 
20 SOUND 52,1233/1 
30 SOUND 46,139VI 
40 SOUND 59,1086/1 
50 SOUND 121,530/1 
60 SOUND 80,1202/1 
70 FOR J=I TO 16 
80 NEXT J 
90 NEXT I 
99 END 


Remark Pitch and duration must be in the range 1 - 65,534. 

A higher value for pitch will produce a lower note. 

A higher value for duration will increase the length of the 
note. 

The formula, 64130/pitch, can be used to find the required 
’duration' parameter to play a note of a specified pitch 
for one second. 

See section 9.12, FOUR OCTAVE SOUND RANGE, for parameters 
to generate specific notes of required frequency. 
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SECTION 5.20 



5.20.6 Function SPACE$ is used to return a string consisting of n spaces. 


Syntax SPACE$(n) 


Example 10 DIM A$ (0,10) 

20 A$ = “123" + SPACE$(3) + "ABCD" 

30 PRINT A$ 

This will print a string consisting of the digits 1,2,3 
followed by 3 spaces followed by the letters A,B,C,D. 


Remarks The parameter n is an integer in the range 0 to 255. 
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SECTION 5.20 



5.20.7 Function SPC moves the cursor along the line by printing spaces 

Syntax PRINT SPC(n) 0<n<255 

Examples 100 PRINT"HELLO»;SPC(10);"HOW ARE YOU ?" 

Will display: 

HELLO HOW ARE YOU ? 

Remarks SPC must be used with one of the PRINT statements. 
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SECTION 5.20 


SQR 


5.20.8 Function SQR returns the square root of the argument. 

Syntax SQR(N) 

where N is a numeric expression. 

Examples Q = SQR (16) 

sets Q equal to 4. 

Remarks The argument must be positive. 
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SECTION 5.20 



5.20.9 Function SRCH function enables an array to be searched for the 
occurrence of a specified element within that array. 


Syntax SRCH«array element), Numerical expression)) 

The array element specified is used as the reference to be 
searched for in the remaining array. 


Examples PRINT SRCH(A$) 

A=SRCH(A(5),3) 

IF SRCH(A!(0), 1 )<>5 THEN 0PCHR7 


Remarks Consider the following program. 

10 DIM A$( 10,20) 

20 A$(0)= n ABCDE" 

30 A$(1)="AB" 

40 A$(2)="ABCDE" 

50 A$(3)="ABODE" 

60 A$(4)="ZXYZ" 

70 A$(5)="ABCDE" 

100 INPUT X,Y 

110 PRINT SRCH(A$(X),Y) 

120 GOTO100 


When found the element number is returned. If not found 
then zero is returned. 

The function searches from the specified element to the end 
of the array. As an option, up to 255 occurrences can be 
checked for by specifying in the argument the number of 
repeat occurrences. 

If this value is 256 or larger a syntax error will occur. 

The result of SRCH is a numeric value which can be used in 
arithmetic expressions etc. 

The search function can also be used on simple or double 
precision arrays. 

The following are the results of search on the above array: 
SRCH(A$) gives 2 : as element (2) is the first 
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SECTION 5.20 


SRCH(A$(2), 1) gives 3 : as element (3) is the first 
occurrence of element (2) 

SRCH(A$(4)) gives 0 : as element (4) is not found else¬ 
where . 

When search is applied to numeric arrays the comparison 
must be exact for equality. 

For string arrays the rules apply as in the 'IF' statement, 
i.e. the comparison is equal if the reference string is 
equal to, or a subset of, the searched string. 

Example: 

PRINT SRCH(A$(1)) 

would return 2 as A$(1) is a subset of A$(2). 
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SECTION 5.20 



5.20.10 Function STOP terminates program execution and prints a message on 
the LCD screen. 

Syntax STOP 

Examples 550 STOP 
causes: 

*BREAK IN LINE 550* 

Remarks Typing C01ST causes execution to continue from 
the line following STOP 
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SECTION 5.20 



5.20.11 Function STR$ converts a numeric expression to a string. 


Syntax STR$(N) 

where N is a numeric expression. 


Examples 10 A = 123.6 

20 B$ = STR$(A) 

Sets B$ = ''123.6" 

10 A = 7.941E12 
20 B$ = STR$(A) 

Sets B$ = "7.941E12" 


Remarks This function permits the use of string operation on 
numbers. 

Exponential notation numbers are represented literally in 
string form. 
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SECTION 5.20 



5.20.12 Function STRXNG$ returns a string of a given length composed of 
similiar characters. 


Syntax A$ = STRING$(X,Y) 
or 

A$ = STRING$(X,Y$) 

The first version will return the string A$ with x 
characters of ASCII code Y. The second version returns with 
a string of the first character of Y$. 


Examples 100 PRINT"PAGE HEADING" 
110 PRINT STRING$(12, 

Will output: 

PAGE HEADING 


Remarks The following statements are equivalent: 

A$ = STRING$ (5,65) 

B$ = STRING$ (5,"A") 

producing a string of five A's in A$ and B$ respectively. 
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SECTION 5.20 


SWAP 


5.20.13 Function SWAP exchanges the values of two variables. 


Syntax SWAP variable 1, variable 2 


Example SWAP A,B this will put the value of variable A 

into B and the value of B into A. 

SWAP A$,B$ this will put the contents of A$ into 

B$ and the contents of B$ into A$. 


Remark Any type of variables may be swapped (single precision, 
double precision or string), but the two variables must be 
of the same type or a Type Mismatch error will occur. 
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SECTION 5.21 


TAB 


5.21.1 Function TAB moves the print position cursor the specified number of 
places from the left-hand margin. 

Syntax TAB(N) 

where N is the PRINT POSITION to begin PRINTING. 

Examples 100 PRINT"C0L 1";TAB(10);"COL 2»;TAB(20);"COL 3" 

Will print: 

COL 1 COL 2 C0L3 

Remarks In an LPRINT statement TAB specifies how many columns to 
skip before starting to print. 

If the value of the numeric expression is less than the 
print position, then TAB is ignored. The value of 
expression must be positive and not exceed 255. 
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SECTION 5.21 


5.21.2 


TAN 


Function TAN returns the tangent of an angle. 

Syntax TAN(N) 

where N is a numeric variable in radians. 

Examples T = TANC2.56) 

sets T equal to the value of the tangent of 2.56 radians. 
PRINT TAN(2.56) gives: 

-.65744712167262 

Remarks The argument is expressed in radians. 

The tangents on angles in degrees may be calculated as 
follows:- 

A = TAN(angle/180*PI) 
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SECTION 5.21 


TIME$ 


5.21.3 Function TIME$ returns an eight character string with the time. It 
is used for reading and setting the software independent 
calandar clock. 


Syntax A$ = TIME$ 
OR 

TIME$ = A$ 


Examples 10 DIM A$(0,8) 
20 PRINT TIME$ 
30 A$ = "10:5" 
40 TIME$ = A$ 


Remarks The eight character string is in the format hh:mm:ss. 

Leading zeros may be omitted, but, for example, if the 
minutes are zero, then one zero has to be entered. 

To enter the time directly type the following: 

TIME$="10:27" 

Seconds must not be entered as this will give a Syntax 
error. Seconds are set to "00" when setting the clock. 
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SECTION 5.21 


TRON/TROFF 


5.21.4 Function TRON and TROFF traces the execution of program lines by 
displaying their line numbers. 


Syntax TRON 
TROFF 


Example TRON 
RUN 

[ 10 ] [ 20 ] [ 30 ] 


TROFF 


Remarks Line numbers are displayed in square brackets, but apart 
from this the program runs normally. The path of the 
program execution can be followed. TROFF turns off the 
trace facility. 
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SECTION 5.23 



5.23.1 


Function VAL performs the inverse of STR$. 
digits into a number. 


It converts a string of 


Syntax VAL ("STRING") 


Examples 10 A$ = "123.6" 

20 B = VAL(A$) 

sets B to 123.6 

Remarks Exponential notation numbers are converted literally. 
Example: 

10 A$ = "2.91E6" 

20 B = VAL(A$) 

sets B = 2.91E6 
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5.23.2 Function 
Syntax 
Examples 

Remarks 


SECTION 5.23 



VARPTR returns the address of the specified variable. 


A = VARPTR(variable) 

100 PRINT VARPTR(B) 

This will display the address of variable 'B*. 
VARPTR will only search RAH page R0. 
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SECTION 5.24 


WAND 


5.24,1 Function WAND selects the bar code decoder to use. 


Syntax WAND=n 


Example WAND = 0 

selects the CODE 39 decode software. 


Remarks HUNTER can have multiple bar code decoder packages loaded. 
This command selects the active decoder. 

Currently implemented are: 

0 - Code 39 
1 - EAN 8/13 

NOTE: It is essential to have the relevant decoder software 
loaded in the factory prior to attempting to use a wand. 
See section 8.5 BAR CODES AND LIGHT PENS for further 
information. 
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SECTION 5.24 


WHILE..WEND 


5.24.2 Function WHILE....WEND executes a set of statements if a condition 
is true. 


Syntax WHILE numeric. expression 


statements 


WEND 

'numeric expression' is evaluated true or false; if the 
expression is true the statements following are executed. 
If false, the statement after WEND is executed. The loops 
may be nested; each WEND associated with the most recent 
WHILE. 


Examples 10 FOR Q=1 TO 10 
20 B(Q)=Q 
30 NEXT 

110 WHILE A< 11 
120 FOR I = 1 TO 10 
130 PRINT B(I); 

140 NEXT 

150 PRINT A:A = A+1 
160 WEND 

The matrix B is printed as long as the A parameter is less 
than 11. 


Remarks Each time WEND is encountered the expression is re¬ 
evaluated. The same precautions should be exercised in 
jumping out of this loop as with F0R....NEXT loops. 

NOTE: WHILE cannot be used with a string expression. The 
statements WHILE and WEND must be on separate lines and no 
other statements must be on those lines. 
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SECTION 5.24 


WINCHR 


5.24.3 Function WINCHR inputs a single character from the optical wand. 


Syntax WINCHR N 

where N is a numeric variable. 


Examples 100 WINCHR N 
110 PRINT N 

This will input a single character from the bar-code wand 
and display it on the LCD screen. 


Remarks This function acts exactly like INCHR, but with the 
optional bar-code wand. The value is returned from the 
bar-code exactly like a keyboard input. 

If a multiple character bar code is scanned then WINCHR 
will return the first character and the rest of the code 
will be ignored. 

As with WINPUT if any key is pressed prior to the bar code 
input, then the input is taken from the keyboard instead. 

NOTE: The bar code format must first be selected using the 
WAND verb. The relevant wand firmware must be resident in 
HUNTER as a system file. If it is not, then a system file 
error will result. 
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SECTION 5.24 


WINPUT 


5.24,4 Function WINPUT acts exactly like INPUT, but with the optional 
bar-code wand. 


Syntax WINPUT prompt, variable. (See also INPUT) 


Examples 100 WINPUT A$ 

110 PRINT A$ 

The bar-code wand input will be stored in A$ and displayed 
on the LCD screen. 


Remarks The string returned from the bar-code is read exactly like 
a keyboard input. If any key is pressed prior to bar-code 
input then the input will be taken from the keyboard 
instead. 

Further details of available bar codes may be found in 
section 8.5, BAR CODES AND LIGHT PENS. 

The use of string variables is recommended to allow for any 
alpha content. 

NOTE: The bar code format must first be selected using the 
WAND verb. The relevant wand software must be resident in 
HUNTER as a system file. If it is not, then a system file 
error will result. 
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SECTION 5.24 


WRITE# 


5.24.5 Function WRITE# outputs data to file 


Syntax WRITE//file no, varl, var2,.,.. varX 


Examples WRITE#2,A$,B$,C 

Will write the variables A$,B$ and C to file number 2, 


Remarks The difference beteen WRITE# and PRINT# is that WRITE# will 
insert commas in the file between the items as they are 
written, while strings are delimited with quotation marks. 
WRITE# will not insert a blank before a positive number is 
written. 
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COMMUNICATIONS 


SECTION 6.1 


INTRODUCTION 


6.1 A principle feature of HUNTER'S architecture is its powerful and 

flexible communications facility. 

HUNTER can communicate freely with most other types of computer, 
from micros to mainframes, using a variety of easily selected 
communication 'Protocols'. These protocols, of both synchronous 
and asynchronous varieties, are chosen for compatibility with 
other systems and are not special to HUNTER. 

To establish communications, HUNTER uses the universally accep¬ 
ted RS-232/V24 communications interface. This interface, used in 
virtually every computer system, terminal, printer and modem, 
allows HUNTER to 'plug in' to other systems without 
modification. 

HUNTER is equipped to act as a 'Data Terminal Equipment' (DTE), 
and together with appropriate protocol selections can resemble 
(partially emulate) many popular computer terminals. In this 
mode, it can be used as a portable computer terminal, accessing 
and communicating with other systems. 

Alternatively, HUNTER can act as a self-contained computer, 
directly supporting peripherals like printers without additional 
equipment. Remember that in this mode, HUNTER may need a 
'crossed cable' or 'modem simulator' to communicate with other 
terminal-equipped devices. 

HUNTER'S can communicate with each other, either side-by-side on 
the bench or over thousands of miles by telecommunication 
channels. 
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SECTION 6,2 


APPLICATIONS 


6.2 HUNTER'S communications can be used for transferring both 
programs and data to other systems. 

Programs can be loaded into HUNTER daily, or as required, from a 
central database. Secure protocols and program-based error 
checks can guarantee accurate copies. 

New, revised or corrected programs can be returned to the data¬ 
base for storage. Database files and command functions can be 
accessed automatically, or under manual control using HUNTER'S 
terminal emulation. 

Data can be collected and down-loaded to mainframe, minicomputer 
or microprocessor storage whenever required. Data transmissions 
can be formatted exactly to resemble existing data terminal 
configurations, allowing HUNTER to slot directly into existing 
software support structures. 

Database information (for instance, tables of names and 
addresses) can be sent to HUNTER for presentation to operatives 
in the field. Collected data can be linked to previously loaded 
database information for instant verification and validation.' 
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SECTION 6.3 


HARDWARE CHARACTERISTICS 


6.3.1 INTERFACE CONNECTIONS 

HUNTER uses a standard communications line via a 25 pin "D" 
connector compatible with the requirements of EIA specification 
RS-232-C. The connections may be summarised as follows in TABLE 
6.1, EIA RS-232-C CONNECTOR SIGNALS. 


TABLE 6.1 EIA RS-232-C CONNECTOR SIGNALS. 


HUNTER is configured as a DTE' Data Terminal Equipment. 

Pin No. Description 

1 Protective Ground 

2 Transmitted Data 

3 Received Data 

4 Request to Send 

5 Clear to Send 

6 Data Set Ready 

7 Signal Ground 

8 Data Carrier Detect 

9 (Not used) 

10 5v Power Out 

11 (Not used) 

12 (Not used) 

13 (Not used) 

14 (Not used) 

15 Transmit Clock 

16 (Not used) 

17 Receive Clock 

18 (Not used) 

19 (Not used) 

20 Data Terminal Ready 

21 (Not used) 

22 Ring Indicator 

23 (Not used) 

24 (Not used) 

25 (Not used) 


6.3.2 ELECTRICAL CHARACTERISTICS 

HUNTER'S output voltages on signals "from-HUNTER" are guaranteed 
to be greater in magnitude then 5V when driving a 4K7 load, in 
accordance with EIA specifications. Typically output voltages 
are 8V in magnitude. 
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HUNTER detects input signals with a "fail safe" characteristic. 
Input signals from -25V to +2.5V are detected as a logical "1" 
or the mark state. Signals from +3.5V to +25V are logical "0" 
or the space state. On the handshake signals the asserted state 
is spacing or logical "0" e.g. CTS. 


To summarise, 

Output: 

Logical "0" or spacing 
Logical "1" or marking 

Input: 

Logical "0" or spacing 
Logical "1" or marking 


Output > +5V with 4K7 load. 
Output < -5V with 4K7 load. 


Input > +3.5V 
Input < +1.5V 


Each input provides a line terminator impedance of 6K8. 

6.3.3 INTERFACE POWER CONTROL 

Under normal circumstances the serial output interface is 
powered down to conserve battery life. The first character 
which requires transmission causes the interface to be powered 
up. A pause of approximately 2 seconds is allowed for the 
interface to settle down and then the character is sent. Further 
characters are not affected in this way. Once powered the 
interface is latched on until HUNTER is switched off or power 
removed using an OUT instruction in either Basic or machine 
code. 

When the interface is powered up it may cause spurious 
characters to appear to be sent out, causing problems with the 
receiving system. These may be overcome by powering the 
interface, prior to requiring the data, by sending any character 
as. soon as HUNTER is switched on. A Basic LPRINT command will 
achieve this. 

Alternatively, the interface may be controlled as follows: 

OUT 132,1 

will turn the interface on and 
OUT 132,0 

will turn the interface off. 
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If the interface is turned off after characters have been sent, 
then further characters will not cause the interface to be 
powered up and they will be lost. 

6.3.4 HANDSHAKE LINES 

The function of each of the handshake lines is described in turn 
in the following section, with the exception of Ring Indicator 
(RI). RI is provided to allow HUNTER to be switched on from an 
external source. 
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COMMUNICATION PORT SOFTWARE 


6.4 HUNTER’S communications format is software controlled. 

If HUNTER fails to communicate, always check the port 
initialisation for the correct format. 

6.4.1 INITIALISING THE PORT 

To initialise, or alter, HUNTER’S communications parameters as 
follows: 

From File Manager, 'COMS', or application program select 
’Initialise communications'. 

You are now in the communications program. All entries are 
menu-type choices, selected by the cursor control keys and 
confirmed by 'enter'. 

Values previously selected are displayed as the initial menu 
option presented. For instance, if '1200 baud' had previously 
been selected, then this option will appear after the heading 
'Rate'. 

HUNTER will prompt first for 'transmission parameters', followed 
by 'Receiving Parameters'. 

Specific parameters are modified by positioning the cursor with 
the cursor left, cursor right keys, and selecting the desired 
option with the cursor up, cursor down keys. 

NOTE: If the HUNTER has been totally reset for any reason, the 
parameters shown on entry to this program may differ from that 
expected. Extended use of the cursor keys will always correct 
any anomolies. 

6.4.2 TRANSMISSION PARAMETER SCREEN 


Transmission Parameters 
Rate-1800 Prtcl-none Pty-none 
CTS-n DTR-n LF-n Echo-y T/O-no Null-0 

press ENTER if acceptable 
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6.4.3 RECEIVING PARAMETER SCREEN 

! Receiving Parameters 1 

! I 

i Rate-1200 Prtcl-none Pty-none ! 

I I 

i RTS-off DSR-n DCD-n T/O-no Serig-off | 

! ! 

i i 

i i 

I press ENTER if acceptable [ 

To re-select the previous entries, press 'ENTER'. 


6.4.4 BAUD RATE (Rate) 


available 

baud 


1200 

75 

1800 

110 

2400 

150 

4800 

300 

EXT 

600 



rates are:- 


The EXT feature is to provide for external clocking when using 
synchronous protocols. 

6.4.5 SELECT PROTOCOL (Prtcl) 


The protocols available on HUNTER are:- 

NONE Systime 

X0N/X0FF IBM 2780 (optional) 

ACK/NAK 

ETX/ACK 

6.4.6 SELECT PARITY (Pty) 

On transmission parity is implemented as follows:- 

a) None bit 8 is reset, i.e. logical 0. 

b) Odd bit 8 is set or reset to cause an odd number 

of logical 1's in the data bits. 

c) Even bit 8 is set or reset to cause an even number 

of logical 1's in the data bits. 
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d) 8-bit All eight bits are transmitted with no mod¬ 

ification. This may be used to transfer binary 
information. 

On reception the implementation is:- 

a) None Parity bit is ignored and set to logical 0. 

b) Odd or Even The data is checked for an odd or even number of 

logical I's. If the check fails then the 
character is received as 255 decimal (OFFH). 

c) 8-bit All eight bits of data are passed to the calling 

program. 

NOTE: The parity fail character (OFFH) is displayed as 4 — on 
the screen. 

6.4.7 HANDSHAKING LINES 

There are handshaking lines provided on the RS-232 port. These 
signals are usually used when operating with a modem. The lines 
conform to the standard RS-232 specification for use with 
modems, for specific applications lines need to be enabled as 
appropriate. In general, a straight 25 way cable will operate 
with most modems. They may also be used when communicating with 
slow devices, e.g. printers or for the HUNTER to hold up 
incoming data. These lines will be discussed in turn. 

6.4.7.1 CTS pin 5 (Clear to send) input to HUNTER. 

This signal, selected on the transmit menu, controls data being 
transmitted. 

If selected (y) then only if the line is active (+ve) will data 
be transmitted. The input is tested at the start of each 
character in async or start of each block in sync. Data 
characters are always completely transmitted even if CTS goes 
inactive. 

If deselected (n) then this input is ignored and data is always 
sent. 

6.4.7.2 RTS pin 4 (Request to Send) output from HUNTER. 

The RTS handshake can be set to operate in three different ways 
from either the Communications Menu or via Basic by poking the 
RTS flag, see section 9.7, MEMORY LOCATIONS. The three modes 
are: 
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6.4.7.3 


6.4.7.4 


a) OFF 


b) HOLD 


c) TRUE 


When this option for RTS is selected the RTS line 
is permanently active (+ve) and its state is not 
altered at any time during communications. 

In this mode the RTS line is normally active 
(+ve) and only goes inactive (-ve) when HUNTER 
has received too many characters and the receive 
buffer is about to overflow. This mode can thus 
be used to hold up a transmitting device until 
HUNTER has removed enough characters from the 
receive buffer such that there is enough space in 
the buffer to allow the transmitting device to 
send more data by raising RTS to active (+ve) 
again. This mode can be used when communicating 
HUNTER to HUNTER via a crossed cable. If a 
synchronous protocol has been selected, RTS 
should not be set to HOLD. 

This mode of RTS is meant for handshaking with a 
MODEM or similar device. When HUNTER wishes to 
transmit data, it first of all raises RTS from 
inactive (-ve) to active (+ve). Then HUNTER 
waits for a reply on the CTS line (if enabled) 
before sending the data in the transmit buffer. 
RTS remains active until all the data has been 
sent and the buffer is empty, then HUNTER returns 
RTS to the inactive state (-ve). 


DCD pin 8 (Data Carrier Detect) input to HUNTER. 


This signal, selected on the receive menu, is used to tell 
HUNTER that received data is valid. 


If selected then only when the signal is active (+ve) is data 
received normally. 

If DCD is inactive then no data will be received, even if the 
data input line has data on it. 

DSR pin 6 (Data Set Ready) input to HUNTER. 

This signal, selected on the receive menu, is used to tell 
HUNTER if the peripheral (usually a modem) is ready to operate. 
If selected, only if DSR is active will HUNTER communicate in 
both directions. 


If DSR is inactive then HUNTER will not transmit or receive 
data. This signal can be ignored by selecting "n" on the receive 
menu. 
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6.4.7.5 DTR pin 20 (Data Terminal Ready) Ouptut from HUNTER 

This signal, selected on the transmit menu, is provided to 
enable modems that require DTR to be present before generating 
carrier. 

If selected (DTR-y), DTR will go to the active (+ve) state if 
either transmission or reception is attempted from the HUNTER. 

If not selected (DTR-n), DTR will only be active if transmission 
from the HUNTER is attempted. 

DTR can also be controlled by the communications power supply 
port 132 (see section 9.8), INVCON. DTR is active when the 
inverter is on. 

6.4.8 Timeouts 

Automatic communication timeouts are provided to signal to user 
programs that the communications lines are quiescent. Separate 
timeouts are user-selectable for both transmit and receive 
channels. The timeouts are designed for use with the Basic 
0NC0MMS statement (see section 5.16.3), but can also be invoked 
manually or by machine code programs. The error number is 
available in the location COMERR (see section 9.7, page 9-38). 

The timeouts have a range of 10-60 seconds in 10 second steps 
and are controlled by memory locations RXTOAF and TXTOAF (see 
section 9.7, page 9-38). These locations can be read or written 
to by user programs. When set to 0 (cleared), the timeouts have 
no effect. When set, they have the following effect: 

6.4.8.1 RXTOAF 

Will cause a 'communications error' if the receive line is 
quiescent for more than the selected period. Reception of any 
character, or noise, will reset the timeout. The timeout is 
initiated by a request for serial input data through a Basic 
'LINPUT' or similar statement. If no attempt is made to read 
the input communications buffer, the timeout will not occur. 

6.4.8.2 TXTOAF 

Will cause a 'communications error' if the HUNTPIP is inhibited 
by the hardware handshake lines CTS (Clear to send) or DSR (Date 
set ready). If either line inhibits transmission from the 
HUNTER, a 'communications error* will occur after the specified 
time. 
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6.4.9 Echo 

The 'echo flag', ECHOF (see section 9.7, page 9-37) determines 
whether transmitted characters are echoed on the HUNTER screen. 
Data transmission and reception are not affected and the 
displayed characters are not passed to user programs or entered 
in the receive buffer. 

Echo can be regarded as a full/half-duplex selection, with 
duplicate characters appearing on the screen if the HUNTER is 
communicating with a full-duplex host with echo 'on'. 

6.4.10 LF 

The line feed flag, LFACT (see section 9.7, page 9-37) 
determines whether a LF character (decimal 10, Hex 'OA') is 
inserted in the data stream transmitted by HUNTER automatically 
following every CR (Decimal 13, Hex 'OD') in the transmitted 
text. 

If selected, on (LF-y), line feeds are inserted after CR even if 
line feed characters are already present in the data. 

If selected, off (LF-n), line feeds are not inserted. However, 
line feeds present in the data will be transmited. 

NOTE: When sending binary data, the LF-y option will insert LF 
characters if the data contains decimal 10, even if the decimal 
10 character is not intended as a CR. Always select LF off (LF- 
n) if using 8~bit transmission. 

6.4.11 Null 

The Null count is provided in the transmission set up for use 
with printers that have a significant carriage return delay and 
when no handshaking or buffer is available. 

If selected, NULL inserts NUL (Decimal 00) characters in the 
data stream after CR (and LF, if selected with the LF-y option). 

The number of nulls is chosen from 0,2,5,10 or 20. these 
options are provided by the HUNTER operating system and cannot 
be varied. 

NOTE: If transmitting binary files in 8 bit mode, null must be 
selected off (Null-0), since it will otherwise insert Null 
(Decimal 0) characters after every CR (Decimal 13) character. 
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6.4.12 


SERIG (Receive channel only) 

The SERIG location (see section 9.7, page 9-38) allows any 
single character in the range 0 - 127 Decimal ('O' - '7F' Hex) 
to be ignored by HUNTER'S serial data reception system. 

Characters rejected by SERIG are not entered in the 
communications buffer or passed to user programs. 

SERIG is provided for use with computer systems that provide 
abundant spurious characters (e.g. XON or DEL) as part of data 
streams. Since filtering these unwanted characters can be 
inconvenient in user programs, SERIG provides a useful solution. 

The value of SERIG is selected by incrementing/decrementing the 
decimal value using the up/down cursor keys and must be set to 
'OFF' when not in use. Serig-off is obtained by incrementing 
past 127 or below 0. 
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ASYNCHRONOUS CHARACTER HANDLING 


6.5.1 HUNTER'S asynchronous serial data communications are handled by 
a communications software package totally separate to the user's 
program or the Basic interpreter. 

The user needs no detailed knowledge of data communication to be 
able to utilise HUNTER'S powerful facilities. The required con¬ 
figuration is selected from 'menus' and operation of the package 
is virtually invisible. 

6.5.2 BUFFERS 

Characters are transferred to and from the serial interface via 
invisible 'buffers' that effectively disconnect the application 
program from the outside world. These buffers ensure a smooth 
flow of data and correct reaction to protocol responses even 
when HUNTER is busy doing something quite different! 

Because the communication package is interrupt driven, the 
execution of user programs is not affected by communication. 
However, the user program may slow down if the serial line is 
busy. HUNTER'S communication buffers are available whenever the 
machine is powered up, even if the application program is not 
requesting communication. Incoming messages will be received 
and held in the buffer, while any outgoing data remaining will 
continue to be sent down the line. Any protocols selected will 
continue to be observed. 

6.5.3 COMMUNICATING WITH USER PROGRAMS 

A user program can transmit and receive characters either singly 
or in blocks. The program may be written in HUNTER BASIC (see 
LPRINT, LINCHR, etc) or a compiled language using the standard 
CP/M calls. 

Irrespective of the content of the user program, all data rates, 
protocols and other selections previously made will be observed 
invisibly by HUNTER'S communication software package. 
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6.5.3.1 Transmission 

When transmitting, HUNTER writes the characters into a buffer. 
If the buffer becomes full, then the user program (BASIC or 
CP/M) is held up until the characters or block are sent. 

If a 'communication failure' is detected, execution of the user 
program will be suspended until manually overridden. 


6.5.3.2 Receiving 

When receiving characters, data receiving commands (LINCHR and 
LINPUT in Basic) will fetch any characters or blocks currently 
held in the reception buffer. 

NOTE: This data may have been received prior to execution of the 
input command 

If data is already in the buffer, then it will be returned 
immediately. If no data is present, HUNTER will wait for 
incoming data, and will return when characters or blocks are 
available. 

Reception of data is completely transparent to the user Basic 
program being run by HUNTER. Data may be sent at any time to 
HUNTER, communications protocols being implemented as selected. 

Use is made of a 256 character input buffer. Received 
characters are placed into the buffer in a 'barrel' fashion. If 
more characters are received than this, without any being read 
by a calling program then the earliest characters are 
overwritten. This is true even if RTS or XON/XOFF handshaking 
is used and is ignored by the sending device. 

The effect of this buffering is to permit reception of 
characters to carry on steadily through calling programs which 
process the characters intermittently. This can give a greater 
overall throughput. 

The buffer is needed by definition for the XON/XOFF and ETX/ACK 
protocols. 
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ASYNCHRONOUS PROTOCOLS 


6.6 NOTE: In this section, 'host' means the device communicating 

with HUNTER, whether it be computer, printer, modem or 
otherwise. 

These protocols may be used by Basic application programs, user 
assembly code, CP/M programs or directly in 'Terminal Emulation' 
mode. 

6.6.1 NONE 
RECEPTION 

As implied, this selection does nothing to control the incoming 
data. It behaves as a simple teletype. Characters are placed 
into the reception buffer and a calling program may read them 
out asynchronously. 

TRANSMISSION 

Each character is transmitted as the calling program requests it 
(except when waiting for the previous character to be sent). 
There is no buffering of the output data. 

6.6.2 XON/XQFF (DC1/DC3) 

RECEPTION 

If an incoming character causes the receive buffer to have 90 or 
more unread characters then an XOFF character (DC3,19 Decimal or 
Control S) is transmitted, which should prevent the host sending 
further characters to HUNTER. When the buffer is reduced to 10 
pending characters, an XON (17 Decimal or Control Q, DC1) is 
transmitted to re-enable the host to HUNTER transmission. 
Subsequent XONs or XOFFs are never transmitted without an 
intervening XOFF or XON respectively. 

TRANSMISSION 

The input data line is also examined for XON or XOFF characters. 

If an XOFF or stream of XOFFs are received then transmission is 
stopped as soon as the character being transmitted is finished. 
The protocol requires an XON to restart transmission. This 
protocol procedure strips 'XON 1 or 'XOFF' Control characters, 
thus returning only valid data. 

6.6.3 SLAVE, HUNTER TO HOST TRANSMISSION 
TRANSMISSION 

It should be noted that following the host transmitting an XOFF, 
it is possible, depending on data link speed, to have a further 
two characters sent out by HUNTER. This is due to the time 
taken to receive the XOFF and the possibility of just missing 
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6.6.3 SLAVE, HUNTER TO HOST TRANSMISSION 
TRANSMISSION 

It should be noted that following the host transmitting an XOFF, 
it is possible, depending on data link speed, to have a further 
two characters sent out by HUNTER. This is due to the time 
taken to receive the XOFF and the possibility of just missing 
the start of the next character. 

At the start of transmission a received XON is assumed, to avoid 
lock-up. 

6.6.4 ETX/ACK 
RECEPTION 

In this protocol HUNTER will send an ACK character (06 Decimal 
or Control F) after reception of an ETX character terminating a 
line that has been ready by Basic. The ETX is stripped from 
incoming data and not sent to Basic. This protocol causes the 
host device to wait at the end of each block of data, which 
should not exceed 130 characters, for an acknowledgement that 
the block has been read. The ETX/ACK acknowledgement is only 
transmitted when the block has been fetched from the buffer by 
Basic. 

TRANSMISSION 

This protocol will send out an ETX (03 Decimal or Control C) 
character after any transmitted carriage return. Transmission 
is then halted until an ACK (06 Decimal or Control F) is 
received from the host. This enables individual data blocks to 
be sent and an acknowledgement awaited. If transmission is to 
another HUNTER the blocks should not exceed 130 characters or 
the input buffer may be exceeded. If an ACK is not received 
within thirty seconds then communication failure is assumed and 
an error message is put up on the screen. 

The ACKs are not returned to the user program. 

By the very nature of this protocol, indeterminate handshaking 
situations may occur if any conditions are altered during 
transmission. 

6.6.5 ACK/NAK 
RECEPTION 

In this mode HUNTER will receive a complete block of data, 
terminated with a carriage return. It will then check for 
parity errors. If one exists then a NAK (21 Decimal or Control 
U) is sent out to the host and the data block ignored. 


VER.V09F 


PAGE 6-14 



COMMUNICATIONS 


SECTION 6.6 


If the block is error-free then the received block is sent 
character by character to Basic. When the carriage return is 
sent to Basic an ACK (06 Decimal or Control F) is sent out to 
the host to indicate successful data block reception. 

TRANSMISSION 

Data blocks are first placed into a transmission buffer. Upon 
receipt of a carriage return from Basic, the entire buffer is 
transmitted. HUNTER then awaits an acknowledgement. If an ACK 
is received then the next data block is assembled into the 
buffer and sent. If a NAK (21 Decimal or Control U) is received 
then a failure is indicated and the entire buffer is sent again. 
If nothing is received after three seconds a NAK is assumed and 
the buffer sent again. The NAKs may be sent a maximum of three 
times. If an ACK is still not received then the communications 
failure message is put on the screen. 

6.6.6 SYSTIME 

6.6.6.1 HUNTER to Systime communications Protocol Specification 

This protocol is provided to facilitate communication between 
HUNTER and Systime model S500 minicomputers. The protocol 
embodies a checksum in addition to parity checks. 

Data is sent in the form of messages which are subdivided into 
one or more fixed length blocks. Each block is individually 
checked and acknowledged before any further blocks are sent. 

DATA BLOCKS 

Each block consists of:- 

1 start character 
64 data characters 
3 checksum 
1 stop character 

The purpose of each character group is as follows:- 
Start Character 

The first block of a message uses SOH (01 Decimal). Further 
blocks use STX (02H) as the start character. 

Stop Character 

The last block of a message uses EOT (04 Decimal), previous 
blocks use ETX (03H) as the stop character. 
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Data Character 

The data characters may consist of any 7 bit pattern with the 
exception of the handshake characters : ACK (06 Decimal), NAK 
(15H) and WACK (13H). 

Checksum 

The checksum is formed as the modulo 256 addition of all data 
characters, with parity reset. The number formed is transmitted 
in ASCII as three decimal digits. Leading zeros are not 
suppressed. The most significant digit is sent first. 

Insufficient Data Characters 

If there are less than 64 characters for the data block, then 
the remainder of the block is filled with NULLS (00 Decimal). 
The characters are ignored on reception. 

Handshaking 

Each block of data must be acknowledged by the receiving device. 
After a successful reception and if the receiver is ready to 
receive another block, then it returns an ACK (06 Decimal). If 
the transfer is deemed unsuccessful for any of the following 
reasons:- 

1) parity fault on any character 

2) Incorrect start or end characters 

3) wrong number of characters 

4) checksum error 

5) timeout (waiting for characters for 4 secs) 

then a failure is returned as a NAK (21 Decimal). 

If the receiver accepts the block, but is not ready for further 
data, then a wait acknowledge WACK (19 Decimal) character 
delaying the transmitter's time out is transmitted. Further 
delays can be accumulated by transmitting WACK's at the rate of 
one every 2 secs. The message is finally accepted with an ACK. 

6.6.7 COMMUNICATIONS FAILURE 

If a failure occurs on transmission and a timeout activates, 
then HUNTER will display 'Communications Failure' on the top 
line of the display. This message may be overriden by pressing 
'X' on the keyboard. This will force transmission for ETX/ACK 
or XON/XOFF; in the case of ACK/NAK then the buffer will be sent 
another three times. 

A timeout can be prevented from occurring after a transmission 
failure by re-initialising the communications. 
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SYNCHRONOUS PROTOCOLS 


6.7 To provide the fast, high integrity communication required by 

most mainframe computers, HUNTER has a synchronous data 
communication capability. 

Communication takes place using synchronous transmission of data 
blocks. These blocks are checked using check characters and 
acknowledged as appropriate using particular protocols. 

Currently available as a factory option is the IBM 2780 * 
communication protocol providing the bisynchronous 
communications. Other protocols are in development. 

6.7.1 IBM 2780 ON HUNTER 

BACKGROUND 

The IBM 2780 is a very popular data transmission terminal used 
for remote job entry. The transmission protocol developed for 
this device has been widely implemented on other mainframes to 
the extent of becoming a de facto industry standard. HUNTER'S 
implementation mimics 2780 protocol to provide well proven, fast 
and extremely reliable data transfers. 

IBM 2780 is used for batch entry by use of "job cards". HUNTER 
is easily programmed to simulate the use of job cards providing 
all the processing facilities normally available on a remote 
terminal. 

HUNTER is the most advanced portable to offer a comprehensive 
implementation of IBM 2780 in true synchronous mode. 

ADVANTAGES 

This well proven and sophisticated protocol gives HUNTER 
reliable, high speed communications over relatively poor data 
links such as the public switched telephone network at speeds as 
high as 2400 baud. 

Use of this standard provides access to a wide range of 
mainframe computer systems, directly and without need for 
supporting equipment. Data files can be exchanged between 
HUNTER and mainframe with great flexibility, convenience and 
dependability. 


*NOTE: IBM and 2780 are registered trademarks of IBM Corp. 
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TABLE 6.2 TECHINCAL IMPLEMENTATION 

: Synchronous transmission using Bisync. 

: Character set - EBCDIC 

: Full CRC generation, error handling and flow control. 

: Modem handshake lines available. 

: Internal or external clocking options. 

: May be used over the public switched telephone network or 
private lines. 

: Records terminated using the EM character, providing optimum 
throughput. 

: The "Wait acknowledge" is fully implemented. 

: Protocol use is completely transparent to user programs. 

: Data Rates - up to 9600 Hz with external clocking. 

- up to 4800 Hz using internal clocking 

The internal self-synchronising feature enables HUNTER to HUNTER 
communications over standard 300 baud asynchronous modems. 

6.7.2 SYNCHRONOUS COMMUNICATION 

Synchronous communication transfers data as a continuous stream 
of data characters, without the need for start and stop bits as 
used in asynchronous communication. This maximises the data 
transfer rate for a given channel bandwidth. For the receiver 
to be able to use the data two levels of synchronisation need to 
take place: 

i) Bit Synchronisation 

This allows the receiver to save the state of each bit 
correctly, preferably sampled at the centre of each bit. 

ii) Character Synchronisation 

Each block of eight bits which represent a character needs 
to be identified from within the data stream. 

6.7.2.1 Bit Synchronisation 

Two techniques are used by HUNTER to achieve bit 
synchronisation. 

External Clocking allows both transmit and receive to be 
synchronised using two independent clocking signals. These 
signals are generated by either a modem or modem eliminator. 
The selection 'CLIO on the speed selection of transmit or 
receive menus selects this mode. 

Two pins are provided for the clock signals. Pin 15 provides 
the transmit clock and pin 17 the receive clod:. 


VER.V09F 


PAGE 6-13 



COMMUNICATIONS 


SECTION 6.7 


On transmit, a rising edge (-12V to +12V) causes a bit to change 
on the transmit output (pin 2). On receive, a falling edge 
(+12V to -12V) causes the state of the receive input (pin 3) to 
be sampled. 

It is important that maximum clock speed on HUNTER should not 
exceed 9600 Hz (giving a data rate of 9600 baud). The minimum 
speed is approximately 100Hz. 

Exceeding this clock rate may cause unpredictable results. 

Alternatively, HUNTER can self clock. This is achieved by 
selecting from the menu the desired transmit and receive baud 
rates in the range 50-4800 baud, as for asynchronous. On 
transmit, the data is sent out by using internal timing, with no 
reference to any external clock source. 

To receive incoming data HUNTER times from rising edges (-12V 
to + 12V) on the receive data line to give internal clocking. 

Self clocking is useful for HUNTER - HUNTER communications. It 
may be used over asynchronous modems to provide both increased 
throughput and data integrity. 

6.7.2.2 Character Synchronisation 

To be able to extract eight bit data characters, HUNTER has to 
synchronise itself to the Incoming characters correctly. This 
is done by detecting special synchronising characters called SYN 
characters (32H). HUNTER considers synchronisation to have been 
achieved after receiving two contiguous SYN characters. 

After receiving the two synchronising characters each group of 
eight received bits are then considered to be a character. 

Synchronisation is considered to have been lost if a line 
turnaround character is received (0FFH). This is equivalent to 
an open line. 

Prior to sending the synchronising characters, HUNTER transmits 
an 0AAH pad character which is to assist in bit synchronisation. 

Every data block whether it consists of one or 500 characters, 
must start with a pad character, and two SYN characters and 
terminate with line turnaround. 
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6.7.3 


6.7.3.1 


6.7.3.2 


6.7.3.3 


BINARY SYNCHRONOUS COMMUNICATIONS (BSC) 

The information carrier for 2780 is the binary synchronous 
communications (BSC) procedure. The character set used is 
EBCDIC (Extended Binary Coded Decimal Interchange Code). The 
following is a description of the subset of BSC used for HUNTER 
2780 emulation. 

NOTE: HUNTER generally operates using the USACII (United States 
of America Standard Code for Information Interchange). Charac¬ 
ters either transmitted or received by Basic will be in ASCII, 
so CHR$, LOPCHR, etc., instructions all generate ASCII charac¬ 
ters. To use EBCDIC the 2780 driver software utilises an ASCII 
to EBCDIC and EBCDIC to ASCII code converter. The conversions 
used are listed in section 9.11, ASCII TO EBCDIC CONVERTION. 

The code used on the transmission channel is transparent to 
Basic programs, and need not concern the programmer. 

Text Blocking 

BSC defines general structural procedures for the blocking of 
information. Several control characters are used for the 
control of message blocks. 

A message consists of one or more blocks of text data. The 
start of text character (STX) is used immediately preceeding 
each block of data. Each data block but the last is terminated 
by an end of transmission block (ETB) character or an 
intermediate text block (ITB) character. The last data block 
ends with an end of text (ETX) character. 

Error Checking 

Each block of data is error checked by the receiver by a cyclic 
redundancy check (CRC). After each transmission the receiver 
normally replies with ACKO or ACK1 - data accepted continue 
sending; of with NAK - data not accepted (e.g. due to a data 
transmission error), retransmit the previous block. 

CRC-16 

HUNTER uses the accepted error checking method of EBCDIC 2780. 
The cyclic redundancy check is a division at both the 
transmitting and receiving stations using the numeric value of 
the message as a dividend, divided by a constant. The quotient 
is discarded and the remainder is used as the check character. 
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6.7.3.4 


6.7.4 


6.7.4.1 


6.7.4.2 


6.7.4.3 


6 . 7 . 4.4 


This is transmitted immediately following an ITB, ETB or ETX. 

The receiver checks this value and finds no error if they are 
equal. 

CRC-16 uses the polynominal (x^+x^+x^+1) as the divisor 
constant. The l6 bit remainder is sent as two eight bit 
characters. This is also sometimes referred to as the BCC 
(Block Check Character). 

Line Bid 

For either HUNTER or base computer to transmit a message, the 
line must first be seized. This requires sending an enquiry 
(ENQ) character. A positive acknowledgement permits the start 
of a message. 

LINK CONTROL CHARACTERS 

The data link is controlled by the use of the following control 
characters: 

SYN (32H) - Synchronous Idle 

This character is used to establish synchronisation. Two 
contiguous SYNs are required for synchronisation. They may also 
be used as pad characters, although never used as such by 
HUNTER. Syncs will be ignored after synchronisation has been 
established except as part of CRC. 

STX (02H) - Start of Text 

This character is used as the start of text preceeding all text 
blocks. It is not part of the CRC accumulation. 

ETB (26H) - End of Transmission Block 

The ETB character indicates the end of a block of data 
characters. A block check character is sent immediately 
following an ETB. A reply is required after an ETB (ACKO, NAK, 
etc). 

ITB (1FH) - End of Intermediate Transmission Block 

ITB is also called IUS or US (Unit Separator). This enhances 
the throughput due to not having to go through a line 
turnaround. The CRC accumulation is reset after an ITB. It is 
not necessary to send an STX after the ITB. 
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6.7.4.5 


6.7.4.6 


6.7.4.7 


6 . 7 . 4.3 


6.7.4.9 


6.7.4.10 


If the error check fails then a NAK is sent at the end of the 
transmitted message, i.e. after the ETB or ETX. The whole of 
the message is retransmitted in the event of a NAK being the 
reply to a complete message block. 

ETX (03H) - End of Text 

ETX is transmitted after a block of characters started by an 
STX. The CRC is sent immediately after an ETX. A reply is 
required to indicate the receiver status. 

EOT (37H) - End of Transmission 


This character terminates a message transmission containing a 
number of blocks. It is also used to indicate a system 
malfunction. 

ENQ (2DH) - Enquiry 

ENQ is used as the line bid to start a transmission sequence. 
ENQ is also used to obtain a repeat transmission of a response, 
in the case of a garbled response. 

ACKO (10H,70H) - Affirmative Acknowledgement 

This is one of two positive acknowledgements to error checked 
message buffers. This informs the transmitting station that the 
message was received satisfactorily. This acknowledgement is 
also used to confirm a request for the line. ACKO alternates 
with ACK1 positive acknowledge. 

Alternating Affirmative Acknowledgement 

Alternating ACKO and ACK1 provides sequential checking of 
replies, this ensures that the blocks are replied to correctly. 
ACKO is used as the response to a line bid. 

It should be noted that ACKO and ACK1 consist of two 8 bit 
characters. 


ACK1 (10H,61H) - Positive Acknowledge 

This is the alternate acknowledge. It is used with ACKO to 
respond correctly to incoming messages. 

MACK (10H,1CH) - Wait Positive Acknowledge 


A receiving station that has correctly received a message 
not yet in a condition to use the data, can send a V/ACX. 
s positive acknowledge. The transmitting station sSkxj' 


but 

It 


is 

is 

;en 
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6.7.4.11 


6.7.4.12 


6.7.4.13 


6.7.4.14 


6.7.4.15 


respond with an ENQ. WACK is also a two character sequence. 
WACKs may be sent indefinitely at 3 second intervals to stop 
further transmission. 

NAK (15H) - Negative Acknowledge 

This character informs the transmitting station that a message 
was received in error. It causes retransmission of the 
erroneous message. 

DLE (10) - Data Link Escape 

Data link escape is used to provide various line control 
characters, e.g. WACK, ACKO, ACK1 and RVI, 

RVI (10H,7CH) - Reverse Interrupt 

Reverse interrupt is used as a positive acknowledgement (in 
place of ACKO or ACK1). However, it requests termination of the 
current message, due to a high priority message needing to be 
sent from the receiving station. 

HUNTER will never generate an RVI but will respond to one. 

DLE EOT (10H,04H) - Disconnect Sequence 

This sequence informs the receiver that the transmitter is 
shutting down. 

IRS (1EH) - Intermediate Record Separator 

This character is used as a delimiter in 3780 configurations. 
Reception of this returns a CR (carriage return). 
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6.7.5 MESSAGE TRANSMISSION 

The following illustrate various message sequences and error 
handling. 

NOTE: TX = Transmitting station. RX = Receiving station. 


Fig 6.1 NORMAL MESSAGE 
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Fig 6.2 UNANSWERED LINE BID (ERROR 01) 


TX E (3 sec bid 
N timeout) 
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E (3 sec bid 
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NOTE: HUNTER will retry for a total of 10 ENQs. Many mainframe 
systems never give up. 


Fig 6.3 ACCEPTED RE-TRANSMISSIONS 
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Fig 6.4 RE-TRANSMISSION REJECTED (ERROR 03) 
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NOTE: Number of re-trys can vary. HUNTER will retry 10 times, 
but some mainframe systems will retry indefinately. 


Fig 6.5 TRANSMISSION DELAY (RECEIVER INITIATED) 
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NOTE: HUNTER does not count VJACK-ENQ sequences. The receiver 
buffer may be cleared. 
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Fig 6.6 TRANSMISSION DELAY (TRANSMITTER INITIATED) 
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NOTE: HUNTER does not count TTD/NAK sequences or generate TTDs. 
Fig 6.7 STX LOST AND DATA IGNORED 
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6.8 

INCORRECT POSITIVE ACKNOWLEDGEMENT (ERROR 03) 
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Fig 6.9 DATA LINK ABORTION ON NO RESPONSE (ERROR 02) 
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NOTE: HUNTER sends out 10 ENQs. 


Fig 6.10 DATA LINK STALEMATE 
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NOTE: Failure to receive further messages could be timed out by 
the Basic applications program. 

6.7.6 HUNTER/2780 SPECIFIC IMPLEMENTION FEATURES 

The foregoing describes in general operations on the 
communications line for 2780 protocol. HUNTER has particular 
features and handling which may be important to users. 

6.7.6.1 Buffer Operation 


To implement this synchronous protocol it is necessary to use 
buffering on transmit and receive so that error checking and 
re-transmission can be performed. 

To enhance throughput there are two buffers each for transmit 
and receive, the operation of which is described below. 
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6.7.6.1.1 Transmit Buffer 

On transmit while one buffer is being filled from the user 
program the other is being sent. When the new buffer is full 
the buffers effectively swap over and the cycle is continued: 


Fig 6.11 TRANSMIT BUFFER 


Characters -► 



Characters --► 


Buffer A is filling whilst buffer B transmits. 


Characters -► 



Characters -► 


Buffer B is filling whilst Buffer A transmits. 

The maximum buffer length, including control characters, that 
can be received is 512 characters. However, some systems are 
only configured for 256 characters. For this reason HUNTER will 
only default to transmitting 200 characters for ease of inter¬ 
facing. 
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Fig 6.12 RECEIVE BUFFER 



Filling buffer A, emptying buffer B. 



Filling buffer B, emptying buffer A. 


As with the transmit buffer arrangement, one buffer is being 
filled from the communications line while the other is being 
emptied by the user program. 


6.7*6.2 Data Format 

HUNTER is able to accommodate 2780 protocol as both fixed and 
variable block lengths. Also, 3780 is accommodated. 

It is possible to configure the bisync emulator to provide very 
flexible interfacing for a variety of different host machines. 

Standard configurations can be made for: 

a) 2780 with variable record length 

b) 2780 with fixed record length 

c) 3780 

The block sizes and record sizes can be adjusted for 
compatibility and maximum throughput on the communication 
channel. 
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6.7.6.2.1 


6 . 7 . 6 . 2.2 


6.7.6.2.3 


6.7.6.3 


Other features which are available for special purposes are: 

a) Intermediate STX 

b) Single record blocks 

c) Space compression 

Features not implemented are: 

a) Transparency 

b) Multi drop 

All features are discussed in detail later. Although they may 
all be selected individually, they may not make a compatible 
protocol. Standard configurations are as follows: 

2780 with variable records 

(This is the default configuration) 

a) Record length = 80 

b) Block length = 200 

c) Multiple records per block 

d) Record Padding disabled 

e) No intermediate STX 

2780 with fixed length records 

a) Record length = 80 

b) Block length = 200 

c) Multiple records per block 

d) Record padding enabled 

e) Intermediate STX enabled 

3780 

a) Record length = 80 

b) Block length = 512 

c) Multiple records per block 

d) Record padding disabled 

e) No intermediate STX 

Space compression is only normally used in 3780 installations. 

HUNTER Card Format 


Virtually all HUNTER data is delimited by CR (carriage return). 
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Blocks of data loaded by LINPUT statements are terminated by CR, 
as are lines of printout. The most straightforward method of 
block creation is to treat data between CRs as cards of data. 

6.7.6.3.1 Transmitting Cards 

On transmit, if a CR is detected in the data, the communication 
software will treat it as a record end. The action taken 
depends upon the amount of room left in the current buffer being 
prepared for transmission. 

For further details on end of record action see section 6.7.6.5. 

6.7.6.3.2 Sending the last Card 

To maintain compatibility with existing transmission programs it 
is essential they should operate without modification. This 
leaves a problem of how to send the final message buffer if it 
has not been filled up. If greater than 5 seconds elapses 
between characters sent from the Basic applications program, 
then the end of a complete transmission sequence is assured and 
the current block terminated by ETX CRC. After this has been 
acknowledged the EOT (end of transmission) is sent to close down 
the line. 

6.7.6.3.3 Receiving Cards 

The computer generating data for transmission to HUNTER will 
also block data into records. 

To provide application programs with "CR" delimiters, any end of 
record is converted to CR. The end of record will depend upon 
the configuration in use. The sequences IUS CRC and IRS will 
always return CR. 

This means that HUNTERS will communicate directly when connected 
back to back. 

BSC receiving stations use ESC sequences for special functions 
like skipping line. These sequences are ESC n where n can be a 
number of printable characters. To avoid confusion when these 
are received HUNTER will ignore received ESCs and their 
associated following character. 
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6.7.6.4 Character Restrictions 

HUNTER does not implement any of the transparency features of 
BSC. It is, therefore, not possible to send any of the 
following characters: 

STX - 02H 
EH - 03H 
ETB - 17H 
EDT - 04H 
SYN - 16H 
NAK - 15H 
DLE - 10H 
US - 1FH 
ESC - 1BH 

If any of these characters are sent then they may either be lost 
or cause disruption to the transmission channel. 


6.7.6.5 Configuring the Protocol 

For maximum flexibility there are a number of features which may 
be controlled by the user. These are controlled by a number of 
flags which are memory locations, listed through this section 
and also in section 9.7 Memory Locations. All of these 
locations are preserved after timing set, as with all other 
communications parameters such as transmission speed. 

They may be changed from within a user program using POKE in 
Basic or direct writing in machine code. Alternatively, the 
Basic program "SENTSYNC" will give a menu of options. A listing 
is included in section 9.5. 

6.7.6.5.1 Record Length - (Memory location F853H or 63571) 

This is a single byte which defines the maximum record length. 
It has a range of 1-255, with a default of 80. When outputing 
data, this length should not be exceeded as there may be 
insufficient space left in the block to accommodate the record. 

If record padding is used, all records are either padded or 
truncated to fit this length. 
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6 . 7 . 6 . 5.2 


6 . 7 . 6 . 5.3 


6 . 7 . 6 . 5.4 


6 . 7 . 6 . 5.5 


Buffer Length - (Memory locations F854-F855, 63572-63573) 

This is a two byte number which defines the maximum length of a 
block. It has a permitted range of 10-512 with a default of 
200. The block length must be greater than the selected record 
length. This control is useful for adjusting the throughput for 
good or bad telephone lines when transmitting over modems or 
acoustic couplers. For a good line, the buffer length could be 
set to maximum so that line turnarounds are kept to a minimum 
and the maximum data is sent in one block. If, however, the 
line is a bad one, then if the buffer length is set to a single 
record length, the amount of data to be re-transmitted in the 
event of a NAK or data corruption due to the bad line, is kept 
to a minimum. On Receive, the block length can be anything up 
to 512 characters. 

It should be remembered that the block includes all control 
characters and record separators. 

Single Record Flag - (Memory location F856H or 63574) 

This flag controls whether there is single or multiple records 
in a block. If set to zero (default value) there will be 
multiple records in each block. If set non-zero, there is only 
one record transmitted per block. 

Record Padding flag - (Memory location F857 or 63575) 

This single byte flag is used to control record padding. If 
this byte is set to non-zero, a record is padded with spaces to 
its maximum length as defined by record length before being 
transmitted. On receiving a record, trailing spaces are 
stripped off. If this flag is set to zero, record padding is 
inhibited and trailing spaces are not stripped on reception. 
The default state of this flag is zero. 

Record padding is only normally used on fixed length 2780 
communications. 

Mode flag - (Memory location F858 or 63576) 

This flag determines the essential difference between 2780 and 
3780. It selects between terminating a record with US (IFH), 
followed by CRC, or with IRS (IEH) followed by CRC. 

2780 mode is the default with the mode flag set to 0. A non¬ 
zero flag selects 3780. 
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2780 mode: 


Fixed length records are terminated by any of the following: 


US,CRC : used for a partly filled buffer 

ETBjCRC : used for a full buffer 

ETX,CRC : used for the last buffer to be sent 


Variable length records are terminated by any of the following: 


EM,US,CRC : used for a partly filled buffer 

EM,ETB,CRC : used for a full buffer 

EM,ETX,CRC : used for the last buffer to be sent 


3780 mode: 

All records are terminated with: 

IRS 

On receive, record terminators (CR) are always returned for: 

US CRC 
IRS 

irrespective of the setting of the mode flag. 

6.7. 6. 5. 6 STX flag - (Memory location F859 or 63577) 

This flag is a single byte and controls the use of intermediate 
STXs. If the flag is set to non-zero, at the start of every 
intermediate record an STX is inserted. If the flag is zero, 
then STXs are not inserted except at the start of the first 
record in a block. Intermediate STXs are ignored on reception. 
The default of this flag is zero. 

This feature is normally only used in 2?80 installations. 

6.7.6.5.7 Retry flag - (Memory location F85A or 63578) 

This single byte flag controls how the protocol handles errors. 
If the flag is set to zero (its default state), then when an 
error in communication causes the HUNTER to re-try sending the 
last block, the HUNTER will re-try 10 times before giving a 
communication error. If, however, the flag is set to non-zero, 
the HUNTER will re-try indefinately until either jt succeeds or 
the operator switches the HUNTER off. 
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6.7.6.5.8 Space Compression flag - (Memory location F85B or 63579) 

This single byte flag controls the operation of space 
compression. If the byte is set non-zero, any string of more 
than 2 spaces is compressed into an IGS character and a space 
count code on transmission. The reverse happens on receive 
(i.e. the codes are expanded to the string of spaces). If the 
byte is set to zero (its default state) spaces are not 
compressed on transmission or expanded on receive. 

This feature is not normally used in 2780 installations. It can 
be used to give increased throughput on a line where there are 
many spaces. 

6.7.6.5.9 Addresses of RAM Locations 


Name 

Location 

(Hex) 

Location 

(Decimal) 

Default 

Value 

Description 

RECLEN 

F853 

63571 

80 

Record length 

BUFLEN 

F854 

63572 

200 

Buffer length 

SRFLG 

F856 

63574 

0 

Single record flag 

RPFLG 

F857 

63575 

0 

Record padding 

EMFLG 

F858 

63576 

0 

Mode flag 

STXFLG 

F859 

63577 

0 

STX flag 

RETRYS 

F85A 

63578 

0 

Retry flag 

SCFLG 

F85B 

63579 

0 

Space compression flag 


NOTE: These flags are preserved during power off and so will 
remain at their previous setting after subsequent power on. 


VER.V09F 


PAGE 6-35 



COMMUNICATIONS 


SECTION 6.7 


FIG. 6.14 SYNCHRONOUS BUFFER ORGANISATION 
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Record Terminator. 

Depending on the state of the 
mode flat, this would be either: 

a) an IRS character, or 

b) an IUS character followed 
by 2 intermediate characters. 


An intermediate STX, Line 

if selected, would be turnaround 

inserted here. characters 

(FFH). 

(Note: If selected 
the STX would not be 
counted as part of 
the Record). 


When calculating the buffer length, space should be included for the 
characters at the start of the buffer (i.e. PAD,SYNS and STX), the characters 
at the end (i.e. ETB or ETX, 2 CRC- characters and 2 line turnaround 
characters) and all the required record terminators and intermediate STXs. 


VER.V09F 


PAGE 6-36 










COMMUNICATIONS 


SECTION 6.7 


6.7.7 USE IN TERMINAL EMULATION MODE 

Although 2780 work stations are not generally interactive 
devices, it is possible to use HUNTER in this mode when, for 
example, testing the system with LOG ON cards, etc. 

When in Terminal Emulation any received data is displayed on the 
screen. 

To transmit, a message character may be typed in directly. 
Provided no mistakes are made, and there is less than 5 seconds 
between each character, the message is sent on the transmission 
channel. 

6.7.8 COMMUNICATION ERROR 

There are a number of different line errors which may occur when 
using this protocol. These are detected and then displayed as 
communications errors. An error number is also displayed. The 
meaning of these error numbers is shown in section 6.7.5, 
MESSAGE TRANSMISSION. If use of the ON COMMS statement is made 
then the error number will be in the COMERR flag. 

There is one exception to this rule, see Fig 6.2, UNANSWERED 
LINE BID. This is the most usual error and will generally be 
due to a connection fault, as no characters have been received. 
The option is then given to: Retry transmission ?(Y/N) if f Y' is 
pressed then HUNTER will send out up to 10 more ENQs (enquiries) 
and the offer of retry made again. If •N t is pressed then the 
error 01 is returned, and if programmed through ON COMMS, 
returns control back to Basic. 


6.7.9 ERROR MESSAGES: 

6.7.9.1 Error 01: Unanswered line bid 

This is due to not receiving any reply in a request for the 
line, usually caused by incorrect connection of the 
communications channel. 

6 . 7 .9.2 Error 02: No response from receiver 

After establishing the line, a buffer has been sent to which no 
response has been given, despite 10 ENQs having been sent. 
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6 . 7 . 9.3 


6.7.9.4 


6.7.9.5 


6 . 7.10 


6.7.11 


Error 03: Response not matched by odd-even block count 

The wrong positive acknowledgement has been given to a buffer, 
despite confirmation requests. 

Error 04: Retransmission rejected 

Repeated transmission of a buffer gets only the NAK response, 
has tried 10 times. 

Error 05: No ENQ after HACK 

Having sent out a WACK no acknowledging ENQ has been received 
for 5 seconds. 

HARDWARE HANDSHAKING 

This protocol is generally used with modems or modem simulators. 
The use of RTS (Request to Send) and CTS (Clear to Send) is 
therefore specified by the modem, particularly if half duplex or 
two wire operation is desired (as on the public switched 
telephone network). Both RTS and CTS may be deactivated as 
usual. 

If they are used, then the following takes place: 

1) If HUNTER is not transmitting then RTS is inactive, 
allowing the remote modem to transmit. 

2) When starting a transmission buffer the RTS is activated. 
Before transmission starts CTS is awaited from the modem. 
When CTS becomes active HUNTER starts transmission. 

3) During transmission RTS is kept active, but CTS is not 
checked, if it became inactive the transmission would be 
broken and synchronism dropped. 

4) At the end of a transmission RTS is deactivated and HUNTER 
awaits reception. 

There are no timeouts on the handshakes. 
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The transmission channel could be the switched public network, 4 
wire private lines etc., 


PAGE 6-38 



COMMUNICATIONS 


SECTION 6.7 


Fig 6.13 HUNTER TO MAINFRAME CONFIGURATION 
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The two modems and the channel could be a modem eliminator for 
nearby operation. 

As can be seen the modems generally create all the clocking in 
this simple arrangement. HUNTER will not generate any actual 
clocking of its own, except when self synchronising to the data. 

The handshake signals RTS and CTS ensure correct data flow over 
a half duplex line (allowing the modems to settle etc.) They 
may not be necessary over 4 wire links. 

6.7.12 HUNTER TO HUNTER CONNECTION 

To operate this protocol back-to-back between two HUNTER'S it is 
only necessary to use a crossed 3 wire lead (TX,RX and ground). 
If the handshake lines are connected, then CTS must be 
deselected on the menu as the handshaking is only configured for 
modem operation. 

HUNTER'S need to be set for self clocking at the designed speed, 
typically 1200 baud or 300 baud over slow speed async modems. 
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TERMINAL EMULATION 


6.8.1 APPLICATION 

In terminal emulation mode, HUNTER can be used as: 

a) A remote terminal for dialup timeshare computer 
services. 

b) As a peripheral to other computers. 

c) As a portable 'Telex', able to communicate with other 
HUNTER'S or data terminals. 

6.8.2 CONFIGURATION 

HUNTER'S RS-232 serial interface is configured to represent a 
Data Terminal Equipment (DTE) for compatibility with Modems and 
other items. 

6.8.3 OPERATION 

First, check that the communication port is correctly 
initialised, see section 6.4, COMMUNICATIONS PORT SOFTWARE. 

6.8.4 SELECTION 

From 'File Manager' select 'TERMINAL EMULATION' mode. You are 
now in HUNTER'S remote computer terminal emulation mode. 

HUNTER is now ready to communicate. 

The function keys are programmed as follows: 

Fn 4.COMS 

Fn 8.SYST 

Keyboard entry causes characters to be transmitted, including 
control characters see section 9.2, ASCII CHARACTER SET. 

Characters sent to the HUNTER will appear on the screen if 
printable. Upper and lower case alphabets are available. 

Exit from Terminal Emulation mode is made via the 'SYST' 
function key. 

6.8.5 PROTOCOLS 

Any protocols selected will be observed by HUNTER'S 
communication software package automatically. Remember that 
block protocols like ACK/NAK will not transmit until 'ENTER' 
(CR) is pressed. 
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6.8.6 Buffers 

It should be remembered that the HUNTER is fully buffered with 
transmit and receive communications buffers, a keyboard buffer and a 
virtual screen effectively keeping early information available for 
use. 

At high receive data rates, e.g. 4800 baud, the receive buffer will 
remain full. If a "stop" is sent to the sending computer (e.g. XOFF 
or control S, sent manually) then the screen display will not stop 
immediately, continuing to display the characters stored in the 
receive buffer until the buffer empties. If this is found 
undesirable, the most straightforward solution is to reduce the data 
rate to 1200 baud. 

If 2780 synchronous transmission is used in terminal mode, a block 
will be sent if the keyboard has not been operated for 5 seconds. 
This does mean that when using terminal emulation in 2780 mode for 
"signing-on", there should be no hesitation or typing errors or the 
block will be sent unexpectedly! 

6.8.7 Auto Power Off 

Terminal Emulation does not power off automatically. This is for 
ease-of-use when operating intermittently with a remote site. If 
auto power off were allowed, modems may drop the line resulting in 
messages lost, etc. 

It is important, therefore, to remember to switch off HUNTER after 
using Terminal Emulation. 

6.8.8 System Call 

User programs can use Terminal Emulation which is provided as system 
call number 43 (see section 3.5.3.44). Selecting "System" (function 
8) in Terminal Emulation will return control to the calling program. 

To use Terminal Emulation from Basic, the following is required: 

1000 A=ARG(43):A=CALL(5) 

Execution will continue after line 1000. 
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From a machine code or compiled program, a system call 43 is 
required, e.g: 


♦ 

LD C,43 ; select call 

CALL 5 
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6. 9 COMMUNICATIONS ERRORS 


HUNTER provides a range of communications error messages to warn 
the user of failure situations. The error messages are designed 
to be trapped by the Basic ONCOMMS statement (see section 
5.16.3) and handled by the user's program. 

However, the errors can occur when HUNTER is under manual 
control (for instance, in TERM mode) or if the user's 
application does not contain ONCOMMS. In this event, HUNTER 
will display: 

* * * Communication Failure * * * 

- - Error nn — 

where nn is the Error number. The attempt at communication can 
be aborted either by powering the HUNTER off or by pressing 
ENTER, in which case control is passed back to the DEMOS file 
manager. 

The available error messages are: 

6.9.1 Error 01: Unanswered line bid 

This is due to not receiving any reply in a request for the 
line, usually caused by incorrect connection of the 
communications channel. (Synchronous mode only). 

6.9.2 Error 02: No response from receiver 

After establishing the line, a buffer has been sent to which no 
response has been given, despite 10 ENQs having been sent. 
(Synchronous mode only). 

6.9.3 Error 03: Response not matched by odd-even block count 

The wrong positive acknowledgement has been given to a buffer, 
despite confirmation requests. (Synchronous mode only). 
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6.9.4 

6.9.5 

6 . 9.6 

6.9.7 

6.9.8 

6.9.9 

6.9.10 

6.9.11 

6.9.12 


Error 04: Retransmission rejected 

Repeated transmission of a buffer gets only the NAK response, 
has tried 10 times. (Synchronous mode only). 

Error 05: Loss of response from receiver. 

No ENQ has been received in reply to a WACK (synchronous mode 
only). 

Error 06: Not used. 

Error 07: Not used. 

Error 08: Receive timeout Error 

No data has been received to a request for input (e.g. LINPUT) 
for the specified time. 

Error 09: Transmit timeout Error 

Transmission has not been able to take place for the specified 
time. 

The error number is available in the location C0MERR (see 
section 9.7, page 9-38). 

Error 10: ETX/ACK timeout Error 

No response has been received for 30 seconds. 

Error 11: ACK/NAK failure 

Three attempts have failed to get an ACK. 

Error 12: Systime failure 

Ten re-transmissions have failed to get an ACK. 


VER.V09F 


PAGE 6-44 



EDITOR 


CONTENTS 


7.1 

INTRODUCTION 

7.2 

INITIATING THE EDITOR 

7.3 

EDITOR OPERATION 

7.4 

EDITOR COMMANDS 

7.4.2 

ARROWS 

7.4.3 

CAPS LOCK AND TAB 

7.4.4 

CHARACTER INSERT 

7.4.5 

DELETE 

7.4.6 

EXIT 

7.4.7 

FILE START AND END 

7.4.8 

FIND 

7.4.9 

LINE DELETE 

7.4.10 

LINE START AND END 

7.4.11 

PAGE SCROLL 

7.4.12 

SAVE 

7.4.13 

WORD SKIP 





EDITOR 


SECTION 7.1 


INTRODUCTION 


7.1 Hunter's built-in text editor provides practical text handling 
facilities. 

It may be used for the creation and alteration of standard ASCII text 
files for reports, correspondence, etc. This feature is invaluable 
for text entry 'on the move' in trains, planes or any other form of 
transport. Text may then be easily printed out on return to the 
office. 

Husky Basie files, which are encoded to save memory and execution 
time, may also be edited directly. These files are recognised by 
their use of the .HBA suffix. It is important, therefore, to 
maintain the .HBA suffix convention when attempting to edit Basic 
programs. 

NOTE: Encoded source files for other interpreted programs e.g. 
MBASIC cannot be edited with this editor. 

7.1.1 Automatic Cont Edit 

On entry to the Editor from either Basic or Demos, the HUNTER is 
forced into Cont mode. This applies even if the Editor has been 
initiated but the HUNTER is still converting a Basic tokenised 
program into its text equivalent and the normal Editor screen is not 
yet displayed. 

If the HUNTER is now powered down, either by manually pressing the 
power key or by auto-timeout due to lack of keyboard operation, then 
on power up the HUNTER re-enters the Editor and continues operation 
from where it ceased at power down. This applies in all cases e.g. 
midway through a search, writing to a file or exiting to Basic and 
recreating a Basic tokenised file from its text equivalent. This 
feature ensures that all data entered into the Hunter whilst in the 
Editor is always accessible to the user. On exit from the Editor, 
either by 'Exit' or 'Save', the HUNTER is forced out of Cont mode 
automatically. Thus, if the HUNTER is powered down, then it will 
power up normally. 

7.1.2 Editor program size check 

When the Editor is initiated, an automatic check on the file size is 
carried out. Since the Editor uses only the TPA for its work space, 
if a text file greater in length than the TPA is attempted to be 
edited, a warning message will be displayed and the operation will be 
aborted. 

NOTE: The file will not have been changed in any way and the Hunter 
will not be in auto Cont mode. 
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In the case of editing a Basic tokenised program, a check is carried 
out on the size of the tokenised program so that its text equivalent 
form would not be greater in length than the size of the TPA. 

Basic programs are tokenised so as to reduce the amount of memory 
required to store the program and increase the speed of operation of 
the Basic program. On converting a Basic tokenised program into its 
text equivalent, the size of the program increases by approximately 
1/3. Hence, although the size of the Basic tokenised program 
(obtained by using the STAT command in DEMOS) indicates that it would 
fit into the TPA, this, of course, does not imply that its text 
equivalent would fit into the TPA and, therefore, it cannot be 
assumed the Basic tokenised program can be edited. 

The maximum size of a Basic tokenised program which can be edited is 
approximately 36K bytes. Hence, for normal applications this size 
check does not impose limitations upon the HUNTER. 
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INITIATING THE EDITOR 


The editor can be invoked from the operating system, DEMOS, or 
directly from BASIC. In either case, procedures are similar but, on 
exit, the user will be returned either to the operating system or 
Basic as appropriate. 

7.2.1 Entry from the operating system, DEMOS 

From DEMOS, either type EDIT, followed by the desired filename, or 
use function key 7 followed by the filename. 

The entry line will look like: 

>EDIT myfile.txt 

This line will edit the file myfile.txt. Pressing Enter will invoke 
the Editor and if the file already exists, will load it into the work 
area. If the file does not exist, it will be created on exit from 
the editor provided text entry has been made. 

It is essential to enter a filename. If the suffix is omitted, the 
file will be assumed to be ASCII and have the standard default 
extention TXT. If it is desired to edit a Basic file, the .HBA 
suffix must be entered. 

Assuming myfile.txt does not exist, the screen will show: 


COL:00 INS:on Caps:off 


Caps Find Cins Save Ldel Exit 


On the top line there are three items of information: 

a) COL:00 

This shows the column which the cursor is in. It is in the 
range 0 to 79. As the cursor moves, it is kept updated and may 
be used for aligning tables, indents in text, etc. 

Column 0 is the left of the virtual screen. Column 79 is t.he 
extreme right of the virtual screen. 
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b) INS:on 

This shows whether character insert is on or off. 

If insert is on, any text entered will be placed at the cursor 
position and any text already present will be moved. With 
insert off, the display will show: 

INS:off 

In this case, entries will overwrite existing text. 

c) Caps:off 

This shows the state of the CAPS lock function which operates as 
described in section 4.5. 

NOTE: The CAPS LOCK inverts upper and lower case alphabetic 
characters, but is not a 'Shift Lock' function. Lower case 
characters are available by pressing 'Shift'. 

Free-format text entry may now proceed as required. The cursor keys 
provide up, down, forward and backspace functions. Lines are 
terminated by 'Enter' which is equivalent to CR (Carriage Return). 

If the file already exists, the first few lines of text will appear 
on the screen. 


COL:00 INS:off Caps:off 
This is a demonstration of entering tex 
the text editor. On this screen it can b 
we only display the top left of the file 

Paragraphs are generally indented, this 
no problem to the Hunter text Editor. 
Caps Find Cins Save Ldel Exit 


This is the beginning of the file and the left-hand forty columns. 
Text editing may now proceed as required. 

NOTE: Exit from the editor after entering from DEMOS will abort any 
changes to the file, unless the file is previously saved. 
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7.2.2 Entry from BASIC 

When in Basic (see section 4), it is possible to use the Editor to 
load a file or to Edit a program which has already been loaded into 
the TPA. 

To Edit a Basic program already resident in the TPA, it is only 
necessary to type: 

EDIT (followed by 'Enter') 
or 


Fn key 3 (followed by 'Enter') 

There will be a slight delay while the Basic program is un-entokened 
to give an ASCII representation. The screen will then appear as 
shown above and editing can proceed as required. 

Alternatively, if a new file is to be loaded into the workspace, 
entering: 

Edit "filename" (followed by 'Enter') 

If the file extension is omitted, the .HBA extension will be assumed 
and will first load the file and then invoke the editor. 

When exiting from the Editor after entering from Basic, use of EXIT 
will cause the ASCII character representation used by the Editor to 
be entokened ready for execution by Basic. This procedure can take a 
few seconds for larger programs. 

After EXIT, the user is returned to Basic. 

NOTE: Any unnumbered lines will not be entokened and consequently 
will be lost. Any duplicated line number will cause the earlier 
entry to be lost. 
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EDITOR OPERATION 


7.3.1 The Editor is incorporated in the operating system as a built-in 
function and operates as a file-based system. 

When a file is loaded into the Editor, it is placed in the TPA (see 
section 3.3), the 5RK workspace used by HUNTER. This is the only 
area in which the Editor operates on a file. The whole file must be 
loaded. 

The maximum text file size wich can be edited is 54K bytes. 

7.3.2 Basic Files 

If an encoded Basic file is loaded, then it is first un-entokened to 
ASCII characters. This is because the Editor will only operate in 
ASCII within its work area. A short delay of a few seconds on entry 
and exit to the Editor will occur when operating on Basic files. 
This delay obviously gets longer with larger programs. 

7.3.3 The Keyboard 

The diagram of the keyboard shown in Fig 7.1, shows the function 
associated with each key when used as a control key (i.e. hold down 
CTL/FN and press the appropriate key). 

All the function keys are replicated as control keys which conform 
broadly to the layout used by Wordstar™. 

NOTE: The Editor uses the virtual screen, so the cursor keys (fully 
described in section 2.6) may be used to scan around the text in the 
virtual screen. 

The label line cannot be turned off with LBL when in the Editor. 

The operating system scans the keyboard every 18ms and stores the key 
code in a 32-key keyboard buffer. This buffer is examined by the 
user's program and operating system whenever necessary. When in the 
Editor mode, the operating system is examining this buffer and taking 
appropriate action when necessary. There are occasions when the 
screen handler cannot keep pace with keyboard entries due to 
considerable and repetitive editor workspace access. This may become 
a problem when an excessive number of character delete key operations 
are performed. It is, therefore, advisable not to invoke the auto¬ 
repeat function when only a limited number of deletes are required. 
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FIG. 7.1 
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7.3.4 Line Length 

The Editor supports lines of greater than 80 characters by wrapping 
round onto the next line. 
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EDITOR COMMANDS 


7.4.1 Commands made through the function and control keys may generally be 
made at any time. 

Each group of commands will be described individually. Reference 
should be made to Fig 7.1 which stows the complete keyboard functions 
available. 

NOTE: Control and function keys are denoted with a leading up 
'carot' ("), e.g. Control G is shown as "G and function 2 as "2. 
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ARROWS 


7.4.2 KEYS: 


trE;~K - 

*rX;M - 

-►:''D: / 'L - 


Up arrow 
Down arrow 
Left arrow 
Right arrow 


FUNCTION: These keys move the cursor non-destructively in the 
required direction. They may be used to place the cursor 
over any character position which is in use. 

These keys will not place the cursor outside the text area, 
i.e, before the beginning of the file, after the end of the 
file, or past the end of the line currently written to. 


REMARKS: The left and right arrow keys will scroll to the 
previous/following line if the end of a line is reached. 

When ’shifted 1 , these keys access the virtual screen. 

When pressed with "CTL/FN", they have the following functions: 

1) Up and down cursor keys adjust display contrast. 

2) Left and Right cursor keys display left and right halves of the 
virtual screen. 
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CAPS LOCK & TAB 


7.4.3 KEYS: LBL - Caps Lock 

1 - Caps Lock 

TAB - Tab 

*1 - Tab 


FUNCTION: CAPS lock forces all alphabetic characters to capitals. 

This function is shown on the top line of the display. 
Pressing caps lock a second time turns the function off. 

TAB moves the cursor onto the next tab position in units of 
o, i.e. column 8, 16, 24, etc. 


REMARKS; CAPS lock is useful for entering programs. 
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CHARACTER INSERT 


7.4.4 KEYS : "3 - Character Insert 

*V - Character Insert 


FUNCTION: This key enables and disables character insert. The 
condition of the function is shown on the top line, e.g. 

INS:on 

When turned off, characters entered overtype existing text. 

When turned on, new text is inserted before the cursor 
position. This is useful for adding characters to the 
middle of a line. 


REMARKS: An exception to the above rule is carriage return (Enter). 

With insert on, a carriage return is added as with any 
other character, causing a break of line if the cursor is 
in the middle of the text. With insert off, the carriage 
return is only added to the file if it is at the end of the 
file, otherwise the cursor is moved non-destructively to 
the beginning of the next line. 
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DELETE 


7.4.5 KEYS: DEL - Delete 

BS - Back space 

"'G - Delete ahead 


FUNCTION Delete destructively moves the cursor back over the 
previous character. The character to the left of the 
cursor is removed and the rest of the line is moved one 
character to the left. 

Backspace operates exactly as back arrow. It moves the 
cursor non-destructively one character to the left. 

Delete ahead destroys the character on which the cursor is 
positioned. The cursor remains stationary and text ahead 
of the cursor is moved towards it. 


REMABKS: Carriage return may be deleted. This has the effect of 
concatenating lines. 

WARNING: Because HUNTER has a 32 character keyboard input 
buffer, ’Deletes' can be stored up in auto-repeat mode more 
quickly than they appear on the screen. This will have the 
effect of 'eating' the text! 

Do not hold the Delete key down. Instead, use single key 
depressions or Line Delete (see section 7.4.9). 
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7.4.6 KEYS: “8 - Exit 

"U - Exit 


FUNCTION: Exit operates slightly differently, depending on whether 
the editor was entered from either DEMOS or Basic. In 
either case, pressing Exit clears the label line and 
presents the question: 

Exit Y/N? 

answering N aborts the command and returns the cursor to 
its previous position. 

Answering Y when entered from DEMOS exits from the editor 
with no change to any file. Any alterations are lost. 

Answering Y when entered from BASIC re-processes the file 
into BASIC encoded form and leaves the edited Basic source 
in the workspace for execution. 

When Exit is in progress: 

** Wait 


is displayed on the bottom line. 
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FILE START AND END 


7.4.7 KEYS: "W - File start 

'"l - File end 


FUNCTION: These commands place the cursor non-destructively at the 
beginning or end of the file. 

File start : positions the cursor on the very first 
character, as if the Editor had just been 
entered. 

File end : places the cursor at the end of the file. 

The screen displays the last line of the file 
and puts the cursor on the second text line 
of the screen, 

REMARKS: Very useful for adding text to a file. 


VER.V09P 


PAGE 7-14 



EDITOR 


SECTION 7.4 


FIND 


7.4.8 KEYS: *2 - Find 

"0 - Find 


FUNCTION: Find is used to seach the file for a specified string. The 
search is only forward from the cursor position to the end 
of the file. There is no search prior to the cursor. 

After activating Find, the label line is cleared and the 
message: 

Find? 

is displayed. The desired string is typed in (up to 68 
characters). After pressing Enter, the search is started 
and the message: 

** Wait 

is displayed. If an exact match for the desired string is 
found then the cursor is placed on the first character. 

If no match is found, the message: 

** Failed 

is displayed on the bottom line and the cursor returned to 
its original position. 

If it is desired to find the same string a second time, 
then pressing only Enter after the "Find?" prompt will 
cause the search to go on through the file looking for the 
next occurrence. This should not be done for the first 
search after entering the Editor as the command will be 
rejected. 


REMARKS: Find can be aborted by entering ESC. 


The "failed" message disappears after any key depression. 
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LINE DELETE 


7.4.9 KEYS: ~7 - Line Delete 

~Y - Line Delete 


FUNCTION: Line delete removes the line on which the cursor is placed. 

The cursor must be placed at the beginning of the line to 
be deleted. 
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LINE START AND END 


7.4.10 KEYS: A Q - Line Start 

*T - Line End 


FUNCTION: These keys move the cursor non-destructively to either the 
beginning or.end of the line. 


REHARKS: Useful for adding text to the end of a line. 
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p AGE SCROLL 


7.4.11 KEYS: A R - Page Up 

A C - Page Down 


FUNCTION These keys are used to scroll the text page by page. 

Page down will firstly place the cursor at the bottom of 
the screen being displayed. Further operations will 
display pages six lines at a time to the end of the file. 

Similarly, page up will initially place the cursor on the 
top line of the display and then backwards page by page to 
the beginning of the file. 


REMAffiCS: Useful for reviewing text. 
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SAVE 


7.4.12 KEYS: A 6 - save 

- save 


FUNCTION: This command is for saving modified text into a file. 

After entering the command, the label line is cleared and 
the message: 

Save Filename ... 

is displayed. If 'Enter' is pressed immediately, the text 
is stored back into the file originally loaded. Otherwise, 
a new file is created with the text. However, if the 
Editor was entered from Basic by simply pressing Edit and 
then Enter, then a new file called 'HUNTER.HBA' will be 
created unless a filename is specified. 


If .HBA suffix is used, then the file will be assumed to be 
a Basic source file. Any other suffix will always create a 
text file. 


REMARKS: If there is insufficient room, then DEMOS is re-entered and 
the error message: 

Disk Full File length = n blocks 

is displayed where n is the number of blocks needed to save 
all the file currently in the Editor. By clearing 
sufficient space in the HUNTER it is possible to save the 
file in the Editor using the file manager command: 

SAVE n filename 

where n is the same number displayed in the error message. 


This will happen even if the Editor was entered from Basic. 
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WORD-SKIP 


7.4.13 KEYS: "A - Left word 

A F - Right word 


FUNCTION: These keys move the cursor non-destructively left and right 
pausing only on spaces. Otherwise, they operate exactly as 
left and right arrow keys. 


REMARKS: A fast method for gaining position in text. 
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OPERATING SYSTEM REPLACEMENT 


8.1 HUSKY Computers pursue a policy of continuous improvement in 

HUNTER'S performance. 

Users may wish to update their version of HUNTER to a later 
enhancement by replacing the operating system ROMs. 

The unit should be returned to HUSKY Computers or authorised 
agents, where the enhancements will be made by experienced 
engineers and returned in the shortest possible time. 
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CASE SEALING 


8.2.1 STANDARD HUNTER 

All HUNTER'S are built with integral seals to provide a high 
degree of protection against atmospheric moisture, corrosive 
gases and accidental immersion, therefore HUNTER should not be 
opened. 

8.2.2 THE BATTERY SEAL 

This is a small 'O' ring seal running in a machined groove in 
the battery plug and seating on a machined face in HUNTER 
casting. 

This seal requires a smear of silicon grease to assist in 
seating. 

8.2.3 SEAL SPECIFICATION 


Dimension Part no. 

1.5mm X 30mm HUN-05710 

Replacement seals may be obtained from HUSKY Computers or 
authorised agents. 
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PRESSURE RELIEF 


8.3 Under certain circumstances (change of altitude, etc.) the 

interior of HUNTER may have a substantial pressure difference 
compared with the environment. This can lead to two 
consequences in HUNTER. 

1) Internal overpressure : making the keys stiff and 
difficult to operate. 

2) External overpressure : a tendency to ingest any 
rainwater adjacent to the seals, and in extreme cases, the 
possibility of activating the keys. 

In either case, any pressure differential can be released by 
slightly loosening the battery cap. 

If you are taking HUNTER on an airline trip, this is a sensible 
precaution to take. 
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HUMIDITY INDICATOR 


8.4 HUNTER'S interior is kept dry by an internal store of silica gel 

desiccant, kept in a muslin bag. The dryness of HUNTER'S 
interior is essential to its correct operation, and is indicated 
by a humidity indicator in the comer of the display window. 

The colour of the indicator should be checked at intervals. 

THE HUMIDITY INDICATOR MUST ALWAYS BE BLUE 

If it takes on a pinkish colour, the unit must be returned to 
HUSKY Computers promptly to avoid corrosion of internal parts. 
If the colour changes immediately after an accident involving 
water or high humidity, a fault has occurred in the sealing, and 
there could be water inside the unit. 

If you suspect that water has entered the interior, you MUST 
take the following action: 


1) Remove the battery 

2) Return HUNTER to HUSKY Computers, or authorised agents. 
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BAR CODES AND LIGHT PENS 


8.5.1 As an option HUNTER is capable of reading 2 types of barcodes: 

a) Code 39 

b) EAN 8/13 

To provide these facilities software packages are loaded into 
the file system of HUNTER as permanent files. Access to these 
files is not allowed to the user. However, the operating system 
accesses the files in order to support the wand option when 
required in programs utilising the Basic statements such as 
WINPUT, WINCHR etc. Access to the files is totally transparent 
to the user. 

Other codes are available to special order. 

If an attempt is made to access these files without them being 
present, then a "system file error" will be displayed. 

See section 9.9.3, LEMO CONNECTOR, for details of connecting and 
removing the LEMO plug. 

8.5.2 BAR CODE SCANNING TECHNIQUES 

There are a few simple rules to follow when using a hand held 
wand: - - 


Check that the tip of the wand is free from dirt. Prolonged use 
of the wand may lead to a build up of dust inside the tip, 
covering the lens. To check for this the tip must be unscrewed 
and, if dust is found, a gentle wipe with a soft cloth will 
remove it. The performance of the wand will not be immediately 
affected by a build up of dust, but rather a gradual decrease in 
the reliability of the wand operation, A weekly check should be 
all that is required for normal use. 

The tips of certain wands are made of plastic and as such, 
pressing the wand firmly onto the bar code will result in tip 
wear. This will affect the wand performance since the focal 
length of the lens will not'coincide with the distance between 
the barcode and the lens,;iVe. the bar code will appear to be 
'out of focus 1 .-' Tt is recommended that the wand be held gently 
in the hand and moved lightly across the bar code for best 
results. 

It is recommended that the scan should be carried out at a 
constant speed with the wand in contact with the barcode 
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throughout the scanning period. The scan should be at right 
angles to the bars of the bar code. However, HUNTER tolerates a 
considerable variation in the scan technique. 

The scan can be slow, fast, traversed across the bar code in an 
arc rather than a perfect straight line, or even scanned in a 
'wavy' line, provided that the wand remains within the bar code 
region. HUNTER will allow both Code 39 and EAN 8/13 bar code 
types to be scanned either left to right or right to left. 


NOTE 'Code 39' is the trademark of Intermec Corp. 

It is not necessary to place the wand precisely at the beginning 
of the bar code before a scan since HUNTER will work out which 
information transmitted from the wand actually corresponds to 
the bar code itself. If the wand is resting on a bar code, it 
is possible to move the wand to either end of the bar code and 
then scan in the opposite direction. HUNTER will then work out 
the beginning and end of the bar code. 

HUNTER will allow a maximum of 16 characters to be represented 
by a Code 39 bar code. This should be borne in mind if the 
reader intends to produce his own Code 39 bar codes. If larger 
codes are required, contact HUSKY Computers for details. 


8.5.3 EUROPEAN ARTICLE NUMBER, EAN 8/13 

There are 2 EAN bar code formats: 

a) EAN 8 Short Version 

b) EAN 13 Full length Version 

Both a) and b) are used in marking retail articles of sale in 
shops, Hypermarkets, warehouses, etc. 

EAN 13, is the general name used to describe a series of barcode 
formats of which ANA (United Kingdom) is one particular version. 
See TABLE 8.1, ASSIGNMENT OF PREFIX DIGITS BY EAN, for precise 
details. 

The general form of EAN 13 is 13 all-numeric digits comprising: 
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First 2 digits 

Prefix denoting the National Numbering Authority administering 
the remainder of the number. 

Next 10 digits 

National Article Number, the structure of which is determined by 
the National Numbering Authority. 

Last digit 

Check digit, calculated by modulo-10 arithmetic, i.e: 

Prefix National Article No. Check 

PI P2 xxxxxxxxxxxxxxxxxxx C 

eg: 5000183962862 

In the above example the prefix is 50, i.e. the numbering 
authority is ANA, the United Kingdom's authority. The National 
Article Number is 0018396286 and the check digit is 2. 

The EAN 8 system is an entirely independent series of numbers of 
8 digit length. The general form of which is: 

First 2 digits 

Prefix, as in EAN 13 

Next 5 digits 

National Short Article Number 
Last digit 
Check digit, 

Prefix 
PI P2 

0 m g • 

50159109 

where, the prefix is 50 and so the National Numbering Authority 
is ANA. The Short Article Number is 15910, and the Check Digit 

9. 


as in EAN 13 

National Article No. Check 

xxxxxxxxxxxxxxxxxxx C 
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The general format of EAN 13 is shown in Fig 8.2, 12 CHARACTER 
BAR CODE. As can be seen, there are 3 types of guard patterns; 
2 normal guard patterns and a centre guard pattern. Only 12 of 
the 13 digits are represented by barcodes and the 13th digit 
must be calculated by considering the mixture of characters 
which represent the first 6 digits. The first 6 digits are 
represented by characters chosen from either Set A or Set B, 
whilst the last 6 digits are represented by characters from Set 
C only. See Fig 8.3, CODING OF NUMBER CHARACTERS. The allowed 
combinations of Set A and Set B characters are shown in TABLE 
8.4, COMBINATION OF SET A AND SET B CHARACTERS. 

The general format of EAN 8 is shown in Fig 2.3, 8 CHARACTER BAR 
CODES. Note in this case that the first 4 digits are all chosen 
from Set A and the last 4 digits from Set C. Again, the guard 
bars are present. 

Due to the fixed parity (all from Set C) of the last 6 digits in 
EAN-13 and the last 4 digits in EAN-8, both types of barcodes 
may be scanned in either direction, i.e. the barcodes are bi¬ 
directional. 
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TABLE 8.1 

ASSIGNMENT OF PREFIX DIGITS BY EAN 

Prefix Values 

00-09 

(Reserved for UPC) 

20-29 

In-Store Numbers 

30-37 

Gencod (France) 

90-43 

CGS (Germany) 

49 

Distribution Code Centre (Japan) 

50 

ANA (United Kingdom) 

54 

ICODIF (Belgium) 

57 

Dansk Varekode Administration (Denmark) 

61-62 

(Reserved for DCI) 

64 

The Central Chamber of Commerce (Finland) 

65-69 

(Reserved for DCI) 

70 

(Norway) 

73 

Swedish EAN Committee (Sweden) 

76 

Schweizerische Artilelkode Vereinigung (Switzerland) 

77 

APNA Australia 

80-83 

(Italy) 

84 

AECOC (Spain) 

87 

UAC (Netherlands) 

90-91 

BAN -Austria 

978 

ISBN 

979 

Reserved for ISBN 

98-99 

Coupon Numbers 
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012345 


678900 


t 

13th DIGIT 
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ENCODED BY 


CHARACTERS IN OCR-B 


VARIABLE PARITY 
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TABLE 8.4 COMBINATIONS OF SET A. AND SET B. CHARACTERS. 


Value of 

13th Digit 

Number Sets used 
half of symbol 

for Coding 

left 

1 

2 

3 

4 

5 

6 

0 

A 

A 

A 

A 

A 

A 

1 

A 

A 

B 

A 

B 

B 

2 

A 

A 

B 

B 

A 

A 

3 

A 

A 

B 

B 

B 

A 

4 

A 

B 

A 

A 

B 

B 

5 

A 

B 

B 

A 

A 

B 

6 

A 

B 

B 

B 

A 

A 

7 

A 

B 

A 

B 

B 

A 

8 

A 

B 

A 

B 

B 

A 

9 

A 

B 

B 

A 

B 

A 
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Fig 8 


5 8 CHARACTER BAR CODE 
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2012 
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8.5.4 CODE 39 

CODE 39 is an alphanumeric bar code consisting of 43 data 
characters (0-9, A-Z, 6 symbols and space) and a unique 
start/stop character These characters are represented by 

light and dark bands, as shown in Fig 8.5, CHARACTER BAR CODE. 

Code 39 is so named due to the structure of each character being 
represented by 9 elements (5 bars and 4 spaces) 3 of which are 
wide and the remaining 6 are narrow. A wide bar or space is 
assigned a value 1, and a narrow bar or space is assigned a 
value 0. Gaps between characters have no value. 

The number of characters in a code is limited only by the 
capabilities of the reader equipment or by human factors if a 
hand held wand is used. 

Each code starts and ends with an asterisk, thus the code 
may be scanned in either direction. 

The width of a unit bar may vary considerably allowing various 
printing methods to be used to produce the characters, e.g: 
offset, letter press, dot matrix printers. The recommended 
standard density is 9.4 characters per inch, but a density of 
1.4 characters per inch may be used for corrugated containers. 

A complete Code 39 bar code consists of a leading white space 
(referred to as a quiet zone), a start character, data 
characters, a stop character and a trailing quiet zone. 

A check digit may be produced if required and is modulus 43. 
The check digit is the last data character and calculated in the 
following manner: 

Suppose the data characters are: 

12345ABCDE/ 

then the sum of the data characters are: 

1+2+3+4+5+10+11+12+13+14+40=115 
Now, 115/43=2 Remainder 29 

The check digit is the character corresponding to the value of 
the remainder, which in this example is 29, i.e. ,, T". 
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Therefore, the complete data character sequence is: 

12345ABCDE/T 

The numeric values assigned to each Code 39 character is shown 
in TABLE 8.6, CODE 39 CHARACTER VALUES. 
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Fig 8.6 CODE 39 CONFIGURATION 


CHAR 

PATTERN 

BARS 

SPACES 

CHAR. 


PATTERN 


BARS 

SPACES 

1 

am a mem 

10001 

0100 

M 

■B 

M H B 

H 

11000 

0001 

2 

a m b ■ n 

01001 

0100 

N 

H 

SUB 

■n 

00101 

0001 

3 

dm as a a a 

11000 

0100 

0 

H 

H i&s m 

H 

J0100 

0001 

4 

mm m mm 

00J01 

0100 

p 

H 

■ WM GG 

H 

01100 

0001 

5 

»*.: ■ m n m 

10100 

0100 

0 

H 

■ H HH 

H 

0001 1 

0001 

6 

• mm aa m a 

01100 

0100 

R 

tn 

H H HH 

H 

10010 

0001 

7 

G 

1 

■ 

■ 

■ 

00011 

0100 

s 

H 

■ Gi m 

H 

01010 

0001 

8 

im m m m m 

10010 

0100 

T 

H 

I m ^M 

H 

00110 

0001 

9 

n HB ■ HE ■ 

01010 

0100 

u 

H 

H H H 

MM 

10001 

1000 

0 

■ B BB BE ■ 

00110 

oioo 

V 

H 

H HI 

■G 

01C01 

1000 

A 

am m m n sm 

10001 

0010 

w 


■ II 

H 

11000 

1000 

B 

a hi ■ n mb 

01001 

0010 

X 

■ 

H HH H 


00101 

1000 

C 

m m a ■ ■ 

11000 

0010 

Y 

BH 

■ m ■ 

■ 

10100 

1000 

0 

■ ■ BH ■ HB 

00101 

0010 

7 

H 

GGH BGG B 

H 

01100 

1000 

E 

h a m a a 

10100 

0010 


H 

h h m 

MM 

00011 

1000 

F 

a aa am m m 

01100 

0010 

• 

H 

H H <m 

H 

10010 

1000 

G 

G 

G 

■ 

■ 

H 

00011 

0010 

SPACE 

H 

mm ■ hg 

■ 

01010 

1000 

hi 

■ I H HB ■ 

10010 

0010 

* 

H 

■ HI HG 

H 

00110 

1000 

1 


01010 

0010 

$ 

H 

H B H 

H 

00000 

1110 

J 

B fl HB H B 

00110 

0010 

/ 

B 

H H H 

H 

00000 

1101 

K 

Bill Hi 

10001 

0001 

4 - 

H 

H H H 

H 

00000 

1011 

L 

B HB H fl HH 

01001 

0001 

% 

H 

■ H H 

H 

00000 

0111 


Tne* symbol denotes a unique starl/stop character which must be (he fust and Iasi character of every code V":, 
More that the stan/stop character is distinct front the asterisk del mod m Tattle G 
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TABLE 8.7 CODE 39 CHARACTER VALUES 


CHAR. 

CODE 

CHAR. 

CODE 

CHAR. 

CODE 

0 

0 

F 

15 

U 

30 

1 

1 

G 

16 

V 

31 

2 

2 

H 

17 

W 

32 

3 

3 

I 

18 

X 

33 

4 

4 

J 

19 

Y 

34 

5 

5 

K 

20 

Z 

35 

6 

6 

L 

21 

- 

36 

7 

7 

M 

22 


37 

8 

8 

N 

23 

Space38 

9 

9 

0 

24 

$ 

39 

A 

10 

P 

25 

/ 

40 

B 

11 

Q 

26 

+ 

41 

C 

12 

R 

27 

% 

42 

D 

13 

S 

28 



E 

14 

T 

29 
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BATTERY CHARGER 


THESE INSTRUCTIONS RELATE TO PERSONNEL SAFETY AS WELL AS 
RELIABLE OPERATION OF HUBSTER AMD BATTERY CHARGER. IT IS 
IMPORTANT THAT THEY ARE READ AND UNDERSTOOD. 

8.6.1 DESCRIPTION 

HUNTER'S rechargable battery system consists of four rechargable 
cells and a HUSKY HUNTER battery charger. 

The cells are 'AA' size Nickel Cadmium (NiCad) of nominally 1.2 
volts, 0.50 Ah and are capable of being charged at 65mA 
continually. 

The special HUSKY HUNTER battery charger is the only unit which 
may be used to recharge the NiCad batteries when they are 
installed in HUNTER. The use of an ordinary AC adaptor/battery 
eliminator may damage HUNTER or the batteries. 

8.6.2 WARNING 

When using the charger be absolutely certain that HUNTER has 
four NiCad cells correctly aligned and no alternative type is 
present. Do not even mix NiCads of differing age or state of 
charge. A risk of chemical leakage, gassing or explosion exists 
if anything other than a matched set of recommended NiCad cells 
are charged. Do not attempt charging at temperatures of 5°C or 
less. 

The charger contains lethal voltages, under no circumstances 
must it be opened, in any way tampered with, or used for any 
other purpose. It must, of course, be kept dry. There are no 
user serviceable items inside the case. 

If the charger is suspected of being faulty, then the fuse 
inside the mains plug may be changed for a similar fuse not 
exceeding 2 amps rating. The charger unit is fully protected 
against continuous short circuits but if unlikely fault 
conditions arise which cause overheating to the charger, it will 
self destruct, quietly and safely. The charger is double 
insulated, making no earth connection. 

8.6.3 OPERATION 

To use the charger unit the following procedure is recommended: 

1) Switch off HUNTER. 

2) Plug the charger into HUNTER'S LEMO connector. 

3) Plug the charger into the mains. 

H) Finally switch mains on. 
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See section 9.9.3, LEMO CONNECTOR, for details of connecting and 
removing the LEMO plug. 

HUNTER operation is possible during use of the charger but the 
current drain will counteract the charging current and 
consequently prolong the time to fully charge the batteries. 
Removal of the cells under this condition is forbidden. 

As with all electrical apparatus the charger should be dis¬ 
connected from the mains when not in use. Only 240 vAC (220 to 
250v) mains, 50 or 60 Hz is suitable for standard units. 
Chargers for alternative mains supplies, e.g. 110v, are 
available. 

Exhausted batteries will typically be fully charged in 12 hours, 
overnight charging is a popular practice. 

8.6.4 NICAD REPLACEMENT 

It must not be forgotten that rechargable batteries do not have 
an unlimited life and will ultimately need replacing as do car 
batteries. If the batteries become exhausted after little use 
then the set may need replacing. Their life expectancy can be 
several years but this is reduced by repeated or prolonged total 
discharge and by excessively high temperatures. 

NOTE: Several discharge/charge cycles are required before NiCad 
cells reach their peak capacity. This type of battery will also 
self discharge, especially at elevated temperatures, which can 
result in a fully charged set of batteries becoming flat in a 
few weeks. An occasional charging session, say, every fortnight 
is recommended if HUNTER is being stored. 

8.6.5 MAINS OPERATION 

For critical or remote operations, permanent charging may be 
called for. This is acceptable provided ventilation around the 
charger and HUNTER is good, but ageing of the cells may be 
accelerated. Annual replacement would be a prudent action in 
this instance. 
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HUNTER SPECIFICATION 


9.1.1 PHYSICAL 

Construction :Diecast aluminium alloy. 

Size :216mm x 156mm x 32nm. 

Weight :(Including batteries) 1150 grammes. 

Sealing :Waterproof against accidental 

immersion. 

Straps :Wrist strap on either side. 

9.1.2 FACIA 

Screen :240 x 64 dot full graphic liquid 

crystal display with keyboard con¬ 
trolled contrast adjustment. 


Keyboard :58 keys arranged in four rows of 15 

Qwerty layout with function and control 
keys. Fully waterproof sealed rubber 
keys. 

9.1.3 PROGRAMMING 

Built-in language rExtended Basic interpreter. 

File handler :CP/M compatible software environment 

allows loading of many popular 
programs. 

Storage :Programs and data stored indefinately 

in battery supported memory. Operating 
system stored in firmware, occupying 
no RAM space. 

Screen handling 

(text mode) :The actual screen of eight 40 

character lines forms a window on a 
larger virtual screen. The window is 
controlled with the cursor keys. 
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Screen handling 

(graphics mode) :Both text and graphics information are 

displayed together. There are five 
selectable character sizes giving 
facilities for elegant, professional 
screen formatting. 

Keyboard :A11 keys re-allocatable in software. 

9.1.4 COMMUNICATIONS 

Type :RS-232/V24 serial port on standard 25 

pin 'D’ type connector. 

Configuration :Entirely software controlled. 

Baud rate :Up to 4800 baud asynchronous. 

Protocols rStandard 'invisible' protocols for 

flow control and security are 
transparent to user programs. Formats 
provided include: (a) none/simple 
'TTY' communication, (b) XON/XOFF 
for mini and main frame computer 
systems, (c) ETX/ACK for many popular 
printers, (d) ACK/NACK for secure 
telephone communication, (e) Systime, 
with BCC error checking, (f) 2780 
fully synchronous implementation. 

Handshaking :RTS, CTS, DTR, DSR, RI., CD, all 

selectable by software. 

9.1.5 GRAPHICS 

Full addressing of 

all 240 x 64 dots rSoftware support for lines, boxes, 

circles and points. 


9.1.6 SOUND 

Fully programmable for:4 octave range 
note and duration. 
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9.1.7 


9 . 1 . 8 . 


9.1.9 


9 . 1.10 


CHARACTER SETS 

Five different sized :True descenders on larger sizes. 

charactersets selectable 

from Basic.Reverse 

video characters 

supported for all sets. 

MEMORY 

Type :CM0S low power semiconductor RAM. 

Retention :Battery support with soldered in Ni/Cd 

backup. 

Capacity .'Available in RAM size options of 80k 

byte, 144k byte and 208k byte. 
Operating system utilises 8k byte of 
this memory. 

Firmware :Built-in operating system including 

file manager, Basic interpreter and 
disk emulator. 

:RAM memory can be upgraded on return 
to factory to larger size 


Upgrading 

REAL TIME CLOCK 


Type 

Accuracy 

Integrity 

MICROPROCESSOR 

Type 

Software 

Cycle time 


:Software accessible time of day and 
calendar clock. Totally independant of 
microprocessor. 

:200ppm worst case, typically 2 sec per 
day. 

:Non volatile, battery backed. 


:NSC800-4 

:Executes the Z-80 instruction set 
(8080 super set); can run standard 
CP/M compatible programs. 

:250ns (4MHz) 
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9.1.11 BATTERIES 

Main 


Secondary 


:Four ’AA' cells, Ni/Cd rechargeable 
for daily use. Mallory MN1500 for long 
shelf life and reliability.Typical 
operating lifetime (software 
dependant) 19h (Ni/Cd) 95h alkaline. 

:Built-in Ni/Cd charged from main cells 
when operating. Life 50h when main 
batteries are discharged. 


HUSKY Computers reserve the right to alter the specification or 
conditions of any product or service without prior notice. 
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2 

DC2 

18 

!! 

34' 

2 

50 

B 

66 

R 

82 

b 

98 

r 

114 

3 

0011 

ETX 

3 

DC3 

19 

# 

35 

3 

51 

C 

67 

S 

83 

c 

99 

s 

115 

4 

0100 

EOT 

4 

DC4 

20 

$ 

36 

4 

52 

D 

68 

T 

84 

d 

100 

t 

116 

5 

0101 

ENG 

5 

NAK 

21 

% 

37 

5 

53 

E 

69 

U 

85 

e 

101 

u 

117 

6 

0110 

ACK 

6 

SYN 

22 

& 

38 

6 

54 

F 

70 

V 

86 

f 

102 

V 

118 

7 

0111 

BEL 

7 

ETB 

23 

' 

39 

7 

55 

G 

71 

W 

87 

s 

103 

w 

119 

8 

1000 

BS 

8 

CAN 

24 

( 

40 

8 

56 

H 

72 

X 

88 

h 

104 

X 

120 

9 

1001 

HT 

9 

EM 

25 

) 

41 

9 

57 

I 

73 

Y 

89 

i 

105 

y 

121 

A 

1010 

LF 

10 

SUB 

26 

* 

42 

: 

58 

J 

74 

Z 

90 

j 

106 

Z 

122 

B 

1011 

VT 

11 

ESC 

27 

+ 

43 

» 

59 

K 

75 

[ 

91 

k 

107 

{ 

123 

C 

1100 

FF 

12 

FS 

28 


44 

< 

60 

L 

76 

\ 

92 

1 

108 

1 

124 

D 

1101 

CR 

13 

GS 

29 

- 

45 

= 

61 

M 

77 

] 

93 

m 

109 

} 

125 

E 

1110 

SO 

14 

RS 

30 

- 

46 

> 

62 

N 

78 

1 

94 

n 

110 


126 

F 

1111 

SI 

15 

VS 

31 

/ 

47 

o 

63 

0 

79 

<- 

95 

o 

111 

DEL 

127 


ft 

o 

H 


ro 


ASCII CHARACTER SET 





APPENDIX 


SECTION 9.4 


NSC800 MACHINE CODE 


INSTRUCTION 

C 

z 

K 

s 

N 

H 

COMMENTS 

ADD A. s; ADC A. s 

t 

\ 

V 

t 

0 

i 

8-bit add or add with carry 

SUB s; SBC A, s. CP s, NEG 

1 

1 

V 

t 

1 

t 

8-bit subtract, subtract with 
carry, compare and 
negate accumulator 

ANDs 

0 

1 

p 

J 

0 

1 

Logical operations 

ORs; XORs 

0 

\ 

p 

1 

0 

0 

And sets different flags 

INC s 

• 

: 

V 

t 

0 

I 

8-bit increment 

DEC m 

• 

i 

V 

1 

1 

t 

8-bit decrement 

ADD DD. ss 

1 

• 

• 

• 

0 

X 

16-bit add 

ADC HL, ss 

1 

i 

V 

t 

0 

X 

16-bit add with carry 

SBC HL. ss 

l 

1 

V 

t 

1 

X 

16-bit subtract with carry 

RLA; RLCA, RRA, RRCA 

I 

• 

• 

• 

0 

0 

Rotate accumulator 

RL m; RLC m; RR m; RRC m 
SLA m; SR A m; SRL m 

t 

\ 

p 

t 

0 

0 

Rotate and shift location s 

RLD, RRD 

• 

i 

p 

t 

0 

0 

Rotate digit left and right 

DAA 

l 

t 

p 

t 

• 

l 

Decimal adjust accumulator 

CPL 

• 

• 

• 

• 

1 

1 

Complement accumulator 

SCF 

1 

• 

• 

• 

0 

0 

Set carry 

CCF 

1 

• 

• 

• 

0 

X 

Complement carry 

INr, (C) 

• 

i 

p 

I 

0 

0 

Input register indirect 

INI; IND; OUTl;OUTD 

• 

j 

X 

X 

1 

X 

i Block input and output 

INI R; INDR; OTIR; OTDR 

• 

i 

X 

X 

1 

X 

1 2 = 0 if B / 0 otherwise Z - 1 

LDI, LDD 

• 

X 

I 

X 

0 

0 

i Block transfer instructions 

LDIR. LDDR 

• 

X 

0 

X 

0 

0 

I P/V * 1 if BC / 0, otherwise 

P/V = 0 

CPI, CPIR, CPD, CPDR 

• 

i 

J 

X 

1 

X 

Block search instructions 

Z = 1 if A= (HU, 
otherwise Z = 0 

P/V = 1 if BC * 0, 
otherwise P/V = 0 

LD A.!; LD A. R 

• 

t 

IFF 


0 

0 

The content of the interrupt 
enable flip-flop (IFF) is 
copied into the P/V flag 

BIT b, i 

• 

i 

X 

X 

0 

1 

The complement of bit b of 
location is copied into the 

NEG 

! 

i 

V 

1 

1 

l 

Z flag 

Negate accumulator 


The following notation it used in thii table: 


SYMBOL OPERATION 

C Carry/iink flag. C-1 if the operation produced a carry from the MSB of the operand or reiult. 

Z Zero flag. 2*1 if the remit of the operation it zero. 

S Sign flag. S*1 if the MSB of the retult is one. 

P/V Parity or overflow flag. Parity (P) and overflow IV) share the same flag, logical operations 
affect this flag with the parity of the result while arithmetic operations affect this flag with 
the overflow of the result. If P/V holds parity, P/V*1 if the result of the operation is even, 
P/V=0 if result is odd. If P/V holds overflow, P/V*1 if the result of the operation produced 
an overflow. 

H Half-carry flag. H*1 if the add or subtract operation produced a carry into or borrow from 
bit 4 of the accumulator. 

N Add/Subtract flag. N=1 if the previous operation was a subtract. 

H and N flags are used in conjunction with the decimal adjust instruction (DAA) to properly 
correct the result into packed BCD format following addition or subtraction using operands 
with packed BCD format. 

t The flag is affected according to the result of the operation. 

• The flag is unchanged by the operation. 

0 The flag is reset by the operation. 

1 The flag is set by the operation. 

X The flag is ■ "don't care." 

V P/V flag affected according to the overflow result of the operation. 

P P/V flag affected according to the parity result of the operation. 

r Any one of the CPU registers A, B, C, D, E, H, L. 

s Any 8-bit location for all the addressing modes allowed for the particular instruction. 

ss Any 16-bit location for all the addressing modes allowed for that instruction. 

ii Any one of the two index registers IX or IY. 

R Refresh counter. 

n 8-bit value in range <0, 25S>. 

nn 16-bit value in range <0, 65535>. 

m Any B-bit location for all the addressing modes allowed for the particular instruction. 


SUMMARY OF FLAG OPERATION 


|_sLzj 

X H X 

P/V 

N 

C 


Sequence of flags in F register 
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APPENDIX 


SECTION 9.4 


MNEMONIC 

SYMBOLIC 

OPERATION 

FLAGS 

OP-COO E 

76 543 210 

NO. 

OF T 

CYCLES 

COMMENTS 

C 


P/V 

S 

N 

H 

LO r. r’ 

t~t' 

• 

• 

ft 

• 

• 

ft 

01 

> 1 

4 

r' 

Reg 

LOf.n 

r - n 

• 

■ 

• 

• 

• 

• 

00 

r 110 

7 

000 

B 










n 


001 

C 

LO r, {HU 

r . (HL) 

• 

■ 

ft 

• 

• 

• 

01 

t no 

7 

010 

0 

LO t. (IX«d> 

r- IIX 4 d) 

• 

• 

ft 

» 

• 

ft 

11 

OH 101 

19 

Oil 

E 









01 

r 110 


100 

H 









- 

d 


101 

L 

LO r. {»Y+d> 

r - (lY+d) 

• 

• 

• 

• 

• 

ft 

11 

111 101 

19 

111 

A 









01 

t 110 












d 



LD mu.» 

(HU - r 

• 

• 

• 

• 

• 

• 

01 

110 r 

7 


LO (IX+d), r 

HX+dl -■ r 

• 

■ 

• 

• 

• 

• 

11 

011 101 

19 










01 

110 i 












d 



LO |lY+d). t 

(1 Y»d) - f 

• 

• 

• 

• 

• 

ft 

11 

111 101 

19 










01 

110 f 












d 



LO (HL). o 

IHU - n 

• 

• 

ft 

• 

• 

ft 

00 

110 110 

10 











n 



LO 0X*dl. n 

HX*dI* n 

• 

• 

• 

ft 

• 

ft 

11 

011 101 

19 










00 

HO 110 












d 












n 



LD IIY*dl. n 

(1Y * d) - n 

• 

■ 

• 

• 

• 

ft 

11 

111 101 

19 










00 

no no 












d 












n 



LD A. (8CI 

A - (80 

• 

• 

• 

• 

• 

• 

00 

001 010 

7 


LD A. (DEI 

A- (DEI 

• 

• 

• 

• 

• 

ft 

00 

011 010 

7 


LD A. Inn) 

A - (nnl 

• 

• 

• 

ft 

• 

ft 

00 

111 010 

13 











n 












n 



LD IBCI. A 

(BCl - A 

• 

• 

• 

ft 

• 

« 

00 

000 010 

7 


LD IDE), A 

(DE> ■ A 

• 

• 

• 

• 

• 

ft 

00 

010 010 

7 


LD (nnl, A 

(nnl • A 

* 

• 

• 

• 

• 

• 

00 

110 010 

n 

13 


LO A. 1 

A - 1 

• 

r 

IFF 


0 

0 

11 

101 101 

9 










01 

oio in 



LD A. R 

A • R 

• 


IFF 


0 

0 

11 

101 101 

9 










01 

011 111 



LD 1. A 

1 • A 

• 

• 

• 

• 

• 

ft 

It 

101 10) 

9 










01 

000 111 



LD R, A 

R • A 

• 

• 

♦ 

ft 

ft 

ft 

11 

101 10) 

9 










01 

001 111 



LO dd. nn 

dd • nn 

• 

• 

• 

• 

ft 

ft 

00 

ddO 001 

10 

dd 

Pair 










n - 

* 

00 

BC 










n 


01 

OE 

LD IX. nn 

1X - On 

• 

• 

ft 

• 

• 

ft 

11 

011 101 

14 

10 

HL 









00 

100 001 


11 

SP 










n - 











“ 

n 



LD IY. nn 

IY - nn 

• 

• 

• 

• 

• 

ft 

11 

111 101 

14 










00 

100 001 












n 












n 



LDHL. Innl 

H • Inn 4 11 

• 

• 

• 

• 

• 

ft 

00 

10) 010 

16 



L * (nn) 







- 

n 











► 

n 



LO dd. (nn) 

dd^ ■ (nn*1) 

• 

• 

« 

• 

• 

ft 

11 

101 101 

20 



dd[_ • (nnl 







01 

ddl Oil 












n 



LO IX. Inn) 

IX H - (nn* 1) 

♦ 

• 

• 

ft 

• 

ft 

11 

011 101 

20 



IX L ■ (nnl 







00 

101 010 












n 












n 



LO IY. Inn) 

IY h - (nn 4 ll 

• 


• 

• 

• 

ft 

11 

111 101 

20 



IY l • Inn) 







00 

101 OIO 











- 

n - 



LD Innl. HL 

lnn 4 1) • H 

• 

• 

• 

• 

• 

ft 

00 

100 oto 

16 



(nn) - L 








n - 
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APPENDIX 


SECTION 9.4 




““ 


MM 

MM 

MM 

MB 

— 


— 

NO 

[— 


MNEMONIC 

SYMBOLIC 






OPCODE 

OF T 


COMMENTS 


C 

2 

P/V 

s 


H 

76 

543 

210 

CYCLES 


ID (on), dd 

lnn*1)• dd H 

• 

• 

• 

• 

9 

9 

It 

101 

101 

20 




(nn)• dd^ 







01 

ddO 

Oil 




ID Inn). IX 

lnn*l) ' IX H 

• 

• 

♦ 

• 

9 

9 

11 

n 

011 

101 

20 




Inn) ■ IX L 







00 

100 

010 




LO Inn). IY 

Inn* 1) • IY h 

• 

• 

• 

• 

9 

9 

11 

n 

111 

101 

20 




Inn) • IY l 







00 

100 

n 

010 




LOSP, HI 

SP- HL 

• 

• 

• 

■ 

• 

9 

11 

111 

001 

6 



LOSP. IX 

SP* IX 

• 

• 

• 

• 

9 

9 

11 

011 

101 

10 











11 

111 

001 




LD SP, IY 

SP • IV 

• 

• 

• 

• 

9 

9 

11 

111 

101 

10 











11 

111 

001 


qq 

Pair 

PUSH qq 

ISP-2)- qq L 

• 

• 

• 

• 

9 

• 

11 

qqO 

101 

11 

00 

BC 


(SP-11- qq H 











01 

DE 

PUSH IX 

ISP-2) - IX L 

• 

• 

• 

• 

9 

9 

11 

011 

101 

15 

10 

HL 


ISP-1) * ix H 







11 

100 

101 


11 

AF 

PUSH IV 

ISP-2) - IY l 

• 

• 

• 

• 

• 

9 

11 

111 

101 

15 




ISP-1) - iy h 







11 

100 

101 




POP qq 

qq H - (SP*1> 
qq L • (SP) 

• 

• 

» 

• 

9 

9 

11 

qqO 

001 

10 



POP IX 

IX H - ISP+1) 

• 

• 

• 

9 

• 

• 

11 

Oil 

101 

14 




IX L - ISP) 







11 

100 

001 




POP IY 

IY H • ISPO) 

• 

• 

• 

• 

• 

9 

11 

111 

101 

14 




IY L - (SP) 







11 

100 

001 




EX DE. HL 

OE - HL 

• 

• 

• 

• 

• 

9 

11 

101 

Oil 

4 



EXAF. AF’- 

AF - AF' 

• 

• 

• 

• 

• 

• 

00 

001 

000 

4 



EXX 

BC BC 

• 

• 

• 

9 

• 

• 

11 

on 

001 

4 

Register bank end 


DE *' DE 











auxiliary register 


HL HL 











bank exchange 

EX (SP). HL 

H- ISP*D 

L - ISP) 

• 

• 

• 

• 

• 

9 

11 

100 

Oil 

19 



EX (SP). IX 

IX H - (SP*1) 

• 

• 

• 

9 

9 

9 

11 

011 

101 

23 




IX L -- (SP) 







11 

100 

Oil 




EX ISP). ) Y 

1Y h •• ISP*1) 

♦ 

• 

« 

• 

9 

• 

11 

111 

101 

23 




1V L - (SP) 



© 




11 

100 

Oil 




LDI 

IDE) - (HL) 

« 

• 

I 

• 

0 

0 

11 

101 

101 

16 

Load (HL) into 


DE • DE* 1 







10 

100 

000 


(DEI. increment the 


-i 

X 

X 











pointers and decrement 


8C - BC-1 











the byte counter (SCI 

LDIft 

IDE) - (HL) 

• 

• 

0 

• 

0 

0 

11 

101 

101 

21 

If BC * 0 


OE - DE*1 







10 

110 

000 

16 

If 8C = 0 


HL - HL+1 

BC • BC-1 

Repeat unlit 

8C = 0 



© 










LOD 

(OE) - (HL) 

• 

• 

l 

• 

0 

0 

11 

101 

101 

16 




DE - DE-1 

HL - HL-1 

BC - BC-1 







10 

101 

000 




LDDH 

IDE) * (HU 

• 

9 

0 

9 

0 

0 

11 

101 

101 

21 

If BC * 0 | 


DE - DE-1 







10 

111 

000 

16 

If BC = 0 


HL - HL-1 

BC - BC-1 
Repeat until 

BC = 0 


© 

© 










CPI 

A - (HL) 

• 

t 

t 

l 

1 

\ 

11 

101 

101 

16 




HL *- HIM 

bc - ec-i 


© 

© 




10 

100 

001 




CPIR 

A-(HU 

0 

! 

5 

\ 

1 

t 

11 

101 

101 

21 

If BC * 0 and A * (HL) 


HL * HLM 







10 

110 

001 

16 

If BC-Oor A-(HU 


BC - BC-1 
Repeat until 

A ■» (HL) or 

BC * 0 


© 

© 










CPO 

A - (HL) 

• 

t 

J 

l 

1 

1 

11 

101 

101 

16 




HL - HL-1 

BC - BC-1 






J 

10 

101 

001 
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APPENDIX 


SECTION 3 A 



SYMBOLIC 



FLAGS 



OP-CODE 

NO 

COMMENTS 

MNEMONIC 








OPERATION 

c 

Z 

P/V 

5 

N 

H 

76 543 210 

CYCLES 




CD 

® 








CPOH 

A - (HL) 

• 

* 

I 

! 

1 

1 

11 101 101 

21 

If BC ' 0and A 1 IHU 


HL - HL-1 







10 111 001 

16 

If BC = Ooi A ' IHL) 


BC • 8C-1 

Repeat until 

A = (HL1 of 

BC = 0 











AOD A. r 

A- A + r 

1 


V 

} 

0 


10 [pool r 

4 

r 

Reg. | 

ADD A, n 

A • A * n 

l 

1 

V 

1 

0 

l 

n [ooo]no 

7 

000 

B 









- n 


001 

C 

AOD A. (HU 

A-At(Hl) 

! 

1 

V 

1 

0 

I 

10 |000|110 

7 

010 

D 

ADD A, (IX+dl 

A * A + MXfdl 

t 

} 

V 

I 

0 

1 

11 011 101 

19 

Oil 

E 









io [ooolno 


100 

H 









d 


101 

L 

AOD A. OY+dl 

A « AtUY<d| 

t 

I 

V 

i 

0 

t 

11 111 101 

19 











io fooolno 




ADC A.s 

A — A♦l♦CY 

I 

1 

V 

I 

0 

I 

Ron 


i n any of i, n. 

SUBi 

A- A-t 

l 

? 

V 

i 

1 

1 

10101 


(HU. (IX+dl. 

SBC A,j 

A • A - $ - CY 

I 

1 

V 

1 

1 


|011| 


IIV *-d) as shown for 

AND s 

A - A s 

0 

I 

p 

; 

1 

1 

|100| 


ADD instruction 

OR $ 

A • A V s 

0 

I 

p 

i 

0 

0 

11101 




XOR» 

A- A s 

0 

i 

p 

i 

0 

0 

11011 


The 

ndicated hits 

CPs 

A - $ 

; 

{ 

V 

! 

1 

i 

mu 


replace the 000 in 

INC r 

f ■ 1 4 1 

• 

J 

V 

1 

0 

l 

00 r 11001 

4 

the ADD set above. 

JNC (HU 

(HU - (HUM 

• 

I 

V 

* 

0 

i 

00 11011001 

11 



INC (JX«d> 

llX+dl - 

• 

! 

V 

1 

0 

I 

ii on ioi 

23 




(IX+dl + 1 







oo nofToo] 




INC (1 Y*d) 

(1 Y+d) •• 

• 

I 

V 

I 

0 

l 

11 111 101 

23 




(1 Y+dM 







oo iiofioo] 




DEC m 

in - m l 

• 

1 

V 


J 

1 



m ii any of r. (HU. 
m < 1 X+d). (I Y*d) as 











shown for INC. 

Same format and 
states ai INC. 

Replace 100 with 











101 

n OP code. 

ADD HL, « 

HL- HL+h 

i 

• 

• 

• 

0 

X 

00 Hi 001 

11 

ss 

Reg. 











00 

BC 

ADC HL.si 

HL-HL+suCY 

: 

I 

V 

I 

0 

X 

11 101 101 

15 

01 

DE 









01 III 010 


10 

HL 

SBC HL. si 

HL-HL-is-CY 

! 

t 

V 

1 

1 

X 

11 101 101 

01 ilO 010 

15 



AOD IX. pp 

IX •- IX + pp 

( 

* 

• 

m 

0 

X 

11 011 101 

15 

PP 

Reg. 









00 ppl 001 


00 

BC 











01 

DE 











10 

IX 











11 

SP 

ADD lY.rr 

IY- lY+n 

I 

• 

• 

• 

0 

X 

11 111 101 

15 

rr 

Reg. 









00 111 001 


00 

8C 











01 

DE 











10 

IY 











11 

SP 

INCh 

« " » ♦ 1 

• 

• 

* 

■ 

• 

• 

00 ijO Oil 

6 



INC IX 

IX - IX ♦ 1 

• 

• 

• 

• 

• 

• 

11 011 101 

00 100 011 

10 



INC IY 

IY - IY* 1 

• 

* 

• 

• 

• 

• 

11 111 101 

00 100 011 

10 



DEC <1 

it - it -1 

• 

• 

• 

• 

• 

• 

00 Hi Oil 

6 



DEC IX 

IX - IX -1 

• 

• 

• 

• 

• 

• 

11 011 101 

oo ioi on 

10 



DEC IY 

IY-lY-1 

• 

• 

• 

• 

• 

• 

11 111 101 

00 101 011 

00 000 111 

10 



RICA 

A 

! 

• 

• 

• 

0 

0 

ft 

Rotate left circular 
accumulator 

RLA 

A 

1 

• 

• 

* 

0 

0 

oo 010 111 

4 

Rotate left 

accumulator 

RRCA 

A 

l 

• 

• 

• 

0 

0 

00 001 111 

4 

Rotate right circular 
accumulator 

RRA 

A 

1 

■ 

• 

• 

0 

0 

00 011 111 

4 

Rotate right 
accumulator 
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APPENDIX 


SECTION 9.4 


MNEMONIC 

SYMBOLIC 

FLAGS 

OP-CODE 

NO 

COMMENTS 


C 

Z 

9N 

s 

N 

H 

76 543 210 

CYCLES 

SET b, r 

'b' 1 

• 

a 

• 

• 

• 

a 

it ooi on 

e 











QD b , 




SET b. (HU 

(HU b - 1 

• 

• 

« 

♦ 

• 

a 

11 001 Oil 

15 











fTT] b no 




SET b. (iX'dl 

(IX«d» b - 1 

• 

• 

• 

• 

* 

a 

ii on lot 

23 











ii ooi on 












. d 












OH b 110 




SETb. (IY»d) 

UY*dl b •• i 

• 

• 

• 

• 

• 

• 

ii m ioi 

23 











ii ooi on 












- d 












fill b 110 




RES b. m 

■b* ° 







ED 


To form new QP-eode 1 


in f. (HU. 








replica 1 1 of SET b, t j 











with 

10 . Flagt and 1 


(IY+d) 









time ttatet for SET 1 











instruction j 

JPr>n 

PC' no 

• 

• 

« 

• 

• 

• 

11 000 on 

10 



JP cc. nn 

If condition 

* 

• 

• 

• 

• 

« 

11 cc 010 

10 

CC 

Condition 


it true 







> n 


000 

NZ non zero 


PC • nn. 







n 


001 

2 rero 


otherwiie 









010 

NC non carry 


continue 









on 

C carry 











100 

PO parity odd 











101 

PE parity even 











no 

P sign pomue 











in 

M sign negative 

JR e 

PC • PC ♦ e 

a 

• 

• 

a 

• 

a 

oo on ooo 

12 











• e-2 * 




JRC.e 

If C = 0. 

a 

a 

• 

a 

• 

a 

oo in ooo 

7 

If condition not met 1 


continue 







- e-2 - 





If C = 1. 








12 

If condition it met | 


PC • PC * e 











JRNC,* 

If C = 1. 

a 

• 

• 

• 

• 

a 

00 110 ooo 

7 

If condition not met | 


continue 







• e-2 • 





IIC = 0. 








12 

If condition n met | 


PC * PC ♦ e 











JR Z. • 

If Z = 0 

• 

• 

* 

• 

• 

a 

00 101 ooo 

7 

If condition not met | 


continue 







e-2 • 





If Z = 1. 








12 

If condition it met ] 


PC ■ PC ♦ * 











JR NZ. e 

If Z = 1. 

• 

a 

* 

• 

a 

a 

00 100 OOO 

7 

If condition not met 


continue 







■ e-2 * 





If Z * 0. 








12 

If condition met 


PC ■- PC * e 











JP (HU 

PC* HL 

• 

• 

• 

• 

• 

a 

11 101 OOI 

4 



JPOXl 

PC * IX 

• 

• 

a 

• 

a 

a 

11 011 101 

11 101 001 

8 



JP (IY) 

PC IY 

• 

• 

♦ 

• 

a 

a 

n in ioi 

11 101 ooi 

8 



DJNZ « 

B- B-l 

• 

• 

• 

• 

• 

a 

00 010 ooo 

8 

If B 

0 


II B • 0. 







• e-2 ■ 





continue 












If B * 0. 

PC • PC ♦ e 








13 

II B 

0 

CALL nn 

(SP-1J * PC H 

• 

• 

• 

• 

• 

a 

11 001 101 

17 




ISP-2) * PC L 







n 





PC- nn 







• n 




CALL cc. no 

II condition 

• 

• 

• 

• 

a 

a 

11 cc 100 

10 

If cc II falte 1 


cc it false 







• n 





continue, 

otherwise 







• • 

17 

If cc it true 1 


tame at 

CALL nn 











RET 

PC L- (SP) 

PC H * (SP*1) 

• 

a 

a 

• 

a 

a 

11 001 001 

•° 



RET cc 

If condition 

• 

• 

a 

a 

a 

a 

11 cc OOO 

5 

If rc 

it false 


cc it falte 












continue. 








11 

11 cc u true | 


otheiwise 









cc 

Condition 


tame at 

RET 









OOO 

001 

NZ non zero 

7 zero 

RETl 

Return from 

• 

• 

o 

a 

a 

a 

11 101 101 

14 

010 

NC non c»iry 

RETN 

interrupt 

Return from 

non maskable 
interrupt 

• 

• 

• 

• 

a 

J 

a 

01 OOI 101 

n ioi ioi 

01 000 101 

14 

oil 

too 

101 

no 

111 

C carry 

PO parity odd 

PE parity even 

P tign positive - 
M sign negative 
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Note* r. r' mean* any of the registers A. B. C. D, E, H. L 
ss is any of the register pain BC. DE. HL, SP 
rr <s any of the register pairs 9C, D£. IV. SP 
(?) P/V flag is 0 if the result of BC-1 * 0, otherwise PA/ -• 1 
© 2 flag is t if A - (HL1, otherwise 2*0 
(5) If the result of B-l ■ 0, the 2 flag is set, otherwise it is reset. 
t represents the extension in the relative addressing mode 
e is a signed two's complement number in the range -. -126. 129 ■ 

e-2 in the op-code provides an effective address of pc f e as PC is incremented by 2 prior to the addition of e 
The notation s^ indicates fail b (0 to 7) ol location *. 

Flag Notation: • - flag not affected, 0 - Hag reset, 1 - Hag set, X = flag is unknown 
t = flag is affected according to the result of the operation 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 


8E 

ADC 

A.(HU 

Add with Carry Oper- 


DD8E05 

ADC 

A,(lX+d) 

and to Acc. 


FD8E05 

ADC 

A.( 1 Y+d) 



8F 

ADC 

A.A 



88 

ADC 

A,8 



89 

ADC 

A,C 



8A 

ADC 

A.D 



88 

AOC 

A,E 



8C 

ADC 

A.H 



8D 

ADC 

A.L 



CE20 

ADC 

A.n 



E04A 

AOC 

HL.BC 

Add with Carry Reg. 


ED5A 

ADC 

HL.DE 

Pair to HL 


ED6A 

ADC 

HL.HL 



ED? A 

ADC 

HL.SP 



86 

ADD 

A.IHL) 

Add Operand to Acc 


OD8605 

ADD 

A.IIX+d) 



FD8605 

ADD 

A,(1 Y+d) 



87 

ADD 

A,A 



80 

ADD 

A,B 



81 

ADD 

A.C 



82 

ADD 

A.D 



83 

ADD 

A.E 



84 

ADD 

A.H 



85 

ADD 

A.L 



C620 

ADD 

A,n 



09 

ADD 

HL.BC 

Add Reg. Pair to HL 


19 

ADD 

HL.DE 



29 

ADD 

HL.HL 



39 

ADD 

HL.SP 



DD09 

ADD 

IX,BC 

Add Reg Pair to IX 


DD19 

ADD 

IX. DE 



D029 

ADD 

tx.ix 



DD39 

ADD 

IX.SP 



FD09 

ADD 

IY.BC 

Add Reg. Pair to IY 


FD19 

ADD 

IY.DE 



FD29 

ADD 

IY.IY 



FD39 

ADD 

IY.SP 



A6 

AND 

{HL1 

Logical 'AND' of 


0DA605 

AND 

(IX+d) 

Operand and Acc. 


FDA605 

AND 

(IY+d) 



A7 

AND 

A 



AO 

AND 

B 



A1 

AND 

C 



A2 

AND 

D 



A3 

AND 

E 



A4 

AND 

H 



A5 

AND 

L 



E620 

AND 

n 



CB46 

BIT 

O.IHLI 

Test Bit b of Location 


DDCB0546 

BIT 

0J IX+d) 

or Reg. 


FDCB0546 

BIT 

0,(1 Y + d) 



CB47 

BIT 

0.A 



C840 

BIT 

0.8 



CB41 

BIT 

O.C 



CB42 

BIT 

0.D 



CB43 

BIT 

0 ,E 



CB44 

BIT 

O.H 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CB45 

8IT 

O.L 

Test Bn b ol Location 

CB4E 

BIT 

1 IHLI 

or Req. 

DDCB054E 

BIT 

l,(IX+d) 


FDCB054E 

BIT 

1,(IY+d) 


CB4F 

BIT 

1 ,A 


j CB48 

BIT 

1,B 


CB49 

BIT 

1,C 


CB4A 

BIT 

1.D 


CB4B 

BIT 

1 ,E 


CB4C 

BIT 

1 ,H 


CB4D 

8IT 

1,L 


CB56 

BIT 

2.IHL) 


DDCB0556 

BIT 

2,(IX+d) 


FDCB0556 

BIT 

2,(IY+d) 


CB57 

BIT 

2,A 


CB50 

BIT 

2,B 


CB51 

BIT 

2,C 


CB52 

BIT 

2,0 


CB53 

BIT 

2,E 


CB54 

BIT 

2,H 


CB55 

BIT 

2,L 


CB5E 

8IT 

3,(HL) 


DDCB055E 

BIT 

3,<IX+d) 


FDCB055E 

BIT 

3,IIY+d) 


! CB5F 

BIT 

3,A 


CB58 

BIT 

3,B 


CB59 

BIT 

3.C 


CB5A 

BIT 

3,D 


CB5B 

BIT 

3.E 


CB5C 

BIT 

3,H 


CB5D 

BIT 

3.L 


CB 66 

BIT 

4,(HL) 


ODCB0566 

BIT 

4,(1 X+d) 


FDCB0566 

BIT 

4,(IY+d) 


CB67 

BIT 

4,A 


CB60 

BIT 

4,B 


CB61 

BIT 

4,C 


CB62 

BIT 

4,0 


CB63 

BIT 

4,E 


CB64 

BIT 

4,H 


CB65 

BIT 

4.L 


CB6E 

8IT 

5,IHLI 


DDCB056E 

BIT 

5,(1 X+d) 


FOCBOB6E 

BIT 

5,IIY+d) 


C86F 

8IT 

5,A 


CB68 

BIT 

5,B 


CB69 

BIT 

5.C 


C86A 

BIT 

5,0 


CB6B 

BIT 

5.E 


CB6C 

BIT 

5.H 


CB6D 

BIT 

5.L 


CB76 

BIT 

6,(HLI 


DDCB0576 

BIT 

6,(1 X+d) 


FDCB0576 

BIT 

6,(tY+d) 


CB77 

BIT 

6,A 


CB70 

BIT 

6.B 


CB71 

BIT 

6.C 


CB72 

BIT 

6.D 


CB73 

8IT 

6,E 


CB74 

BIT 

6,H 


CB75 

BIT 

6.L 


CB7E 

BIT 

7,(HU 


DDCB0576 

BIT 

7,(IX+d) 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

FDCB057E 

BIT 

7,<IY*d) 

Test Bit b Location 

CB7F 

BIT 

7,A 

or Reg. 

CB78 

BIT 

7.B 


CB79 

BIT 

7,C 


CB7A 

BIT 

7.D 


CB7B 

BIT 

7.E 


CB7C 

BIT 

7.H 


C87D 

BIT 

7.L 


008405 

CALL 

C,rm 

Call Subroutine at 

FC8405 

CALL 

IVJ.nn 

Location nn if Condi- 

D48405 

CALL 

NC.nn 

tion True 

C48405 

CALL 

NZ,nn 


F48405 

CALL 

P,nn 


EC8405 

call 

PE.nn 


E48405 

CALL 

PO.rm 


CC8405 

call 

Z,nn 


CD8405 

CALL 

nn 

Unconditional Calf to 

Subroutine at nn 

3F 

CCF 


Complement Carry 

Flag 

BE 

CP 

(HL) 

Compare Operand 

DDBE05 

CP 

(IX+d) 

with Acc. 

FDBE05 

CP 

flY+dl 


BF 

CP 

A 


B8 

CP 

B 


B9 

CP 

C 


BA 

CP 

D 


BB 

CP 

E 


BC 

CP 

H 


BD 

CP 

L 


FE20 

CP 

n 


E0A9 

CPD 


Compare Location 
(HLI and Acc. 

Decrement HL and BC 

EDB9 

CPDR 


Compare Location 
(HL) and Acc. Decre¬ 
ment HL and BC. 

Repeat until BC - 0 

EDA! 

CPI 


Compare Location 
(HL) and Acc., Incre¬ 
ment HL and Decre¬ 
ment BC 

EDB1 

CPIR 


Compare Location 
(HL) and Acc. Incre¬ 
ment HL, Decrement 

BC, Repeat until 

BC -0 

2F 

CPL 


Complement Acc. (1*s 

Comp) 

27 

DAA 


Decimal Adjust Acc. 

35 

DEC 

<HL> 

Decrement Operand 

DD3505 

DEC 

(IX+d) 


FD3505 

DEC 

tl Y+d) 


3D 

DEC 

A 


05 

DEC 

B 


OB 

DEC 

BC 


OD 

DEC 

C 


15 

DEC 

D 


IB 

DEC 

DE 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

ID 

DEC 

E 

Decrement Operand 

25 

DEC 

H 


28 

DEC 

HL 


DD2B 

DEC 

IX 


FD2B 

DEC 

IY 


2D 

DEC 

L 


3B 

DEC 

SP 


F3 

Dl 


Disable Interrupts 

102E 

DJNZ 

e 

Decrement B and 

Jump Relative if B =*’0 

FB 

El 


Enable Interrupts 

£3 

EX 

<SP),HL 

Exchange Location 

DDE3 

EX 

ISP).IX 

and (SP) 

FDE3 

EX 

(sp).iv 


08 

EX 

AF.AF’ 

Exchange the Con¬ 
tents of AF and AF' 

EB 

EX 

DE.HL 

Exchange the Con¬ 
tents of DE and H L 

D9 

EXX 


Exchange the Con¬ 
tents of BC.DE.HL 
with Contents of 

BC'.DE'.HL' Respec 
tively 

76 

HAI.T 


HALT fVVait for Inter¬ 
rupt or Reset) 

ED46 

!M 

0 

Set Interrupt Mode 

ED56 

IM 

1 


ED5E 

IM 

2 


ED78 

IN 

A.(C) 

Load Reg with Input 

ED40 

IN 

B.(C) 

from Device 1C) 

ED48 

IN 

C.1CI 


ED50 

IN 

0,(01 


ED58 

IN 

E.ICI 


ED60 

IN 

H.(C) 


ED68 

IN 

L,(C) 


34 

INC 

(HL) 

Increment Operand 

DD3405 

INC 

(IX+d) 


FD3405 

INC 

OY+d) 


3C 

INC 

A 


04 

INC 

B 


03 

INC 

BC 


oc 

INC 

c 


14 

INC 

D 


13 

INC 

DE 


1C 

INC 

E 


24 

INC 

H 


23 

INC 

HL 


DD23 

INC 

IX 


F D23 

INC 

IY 


2C 

INC 

L 


33 

INC 

SP 


DB20 

IN 

A.(n) 

Load Acc with 

Input from Device n 

EDAA 

IND 


Load Location (HL) 
with Input from Port 
(C), Decrement HL 
and B 
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OBJ 

CODE 

source 

STATEMENT 

OPRRTION j 

EDBA 

INDR 


Load Location IHL) 
with Input from Port 
(C). Decrement HL 
and Decrement B. 

Repeat until B 0 

EDA2 

INI 


Load Location <HL! 
with Input from Port 

1C); Increment 

HL and Decrement B 

EDB2 

INIR 


Load Location (HLI 
with Input from Port 
(C), Increment HL 
and Decrement B. 

Repeat until 8 0 

E9 

JP 

(HL) 

Unconditional Jump 

DDE9 

JP 

(IX) 

to Location 

C38405 

JP 

nn 


FDE9 

JP 

(IY) 


DA8405 

JP 

C,nn 

Jump to Location if 

FA8405 

JP 

M ( nn 

Condition True 

□28405 

JP 

NC.nn 


C28405 

JP 

NZ.nn 


F28405 

JP 

P.nn 


EA8405 

JP 

PE,nn 


E28405 

JP 

PO.nn 


CA8405 

JP 

Z,nn 


382E 

JR 

C.e 

Jump Relative to 

3026 

JR 

NC.e 

PC+e if Condition 

202E 

JR 

NZ,e 

True 

282E 

JR 

Z.e 


1826 

JR 

e 

Unconditional Jump 

Relative to PC+e 

02 

LD 

<t3C),A 

Load Source to Des- 

12 

LD 

IDE).A 

tmation 

77 

LD 

(HL).A 


70 

LD 

IHL1.B 


71 

LD 

(HL).C 


72 

LD 

(HLI,0 


73 

LD 

IHD.E 


74 

LD 

IHD.H 


75 

LD 

(HL).L 


3620 

LD 

(HL),n 


DD7705 

LD 

(IX+d),A 


DD7005 

LD 

(IX+d),B 


DD7105 

LD 

(IX+dl.C 


OD7205 

LD 

(IX+d),D 


DD7305 

LD 

(IX+d).E 


007405 

LD 

lIXtdl.H 


DD7505 

LD 

(IX+dl.L 


DD360520 

LD 

(IX+dl,n 


FD7705 

LD 

(1Y +d),A 


FD7005 

LD 

ilY +-d},B 


FD7105 

LD 

(IY<-d),C 


FD7205 

LD 

(IY+d],D 


F07305 

LD 

UY+dl.E 


FD7405 

LD 

(IY + d).H 


F07505 

LD 

(IY+d),L 


F0360520 

LD 

HY+dl.n 


328405 

LD 

(nn),A 


ED438405 

LD 

(nn).SC 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

ED538405 

LD 

(nn).DE 

Load Source to Des- 

228405 

LD 

(nn),HL 

tination 

OD228405 

LD 

Inn),IX 


FD228405 

LD 

<nn),lY 


ED738405 

LD 

(nn).SP 


OA 

LD 

A.ieci 


1A 

LD 

A.IDE) 


7E 

LD 

A,<HLI 


DD7E05 

LD 

A.IIX+dl 


FD7E05 

LD 

A,(IY*-d) 


3A8405 

LD 

A,Inn) 


7F 

LD 

A,A 


78 

LD 

A,B 


79 

LD 

A.C 


7A 

LD 

A,D 


7B 

LD 

A,E 


7C 

LO 

A.H 


ED57 

LD 

A.I 


7D 

LD 

A,L 


3E20 

LD 

A,n 


ED5F 

LD 

A,R 


46 

LD 

B.fHLI 


DD4605 

LD 

B,(IX+dl 


F D4605 

LD 

BJIY+d) 


47 

LD 

B.A 


40 

LD 

B,B 


41 

LD 

B.C 


42 

LD 

B.D 


43 

LD 

B,E 


44 

LD 

B.H 


45 

LD 

B.L 


0620 

LD 

B,n 


ED4B8405 

LD 

BC,(r>n) 


018405 

LD 

BC,nn 


4E 

LD 

C.(HL) 


DD4E05 

LD 

c.nx+di 


FD4E05 

LD 

C.llYni) 


4F 

LD 

C.A 


48 

LO 

C.8 


49 

LD 

c,c 


4A 

LD 

C,D 


48 

LD 

C.E 


4C 

LD 

C.H 


4D 

LD 

C,L 


0E2O 

LD 

C,n 


56 

LD 

D.lHLl 


DD5605 

LD 

D,(IX+d) 


FD5605 

LD 

D,(IY+d) 


57 

LD 

D.A 


50 

LD 

D,B 


51 

LD 

D.C 


52 

LD 

D.D 


53 

LD 

D,E 


54 

LD 

D,H 


55 

LD 

D,L 


1620 

LD 

D,n 


ED5B8405 

LD 

DE.(nn) 


118405 

LD 

DE,nn 


5E 

LD 

E.IHLI 


DD5E05 

LD 

E,(IX+d) 


FD5E05 

LD 

E,(IY+d) 


5F 

LD 

E f A 


58 

LD 

E,B 


59 

LD 

E,C 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

5A 

LD 

E,D 

Load Source to Des- 

5B 

LD 

£,E 

tination 

5C 

LD 

£,H 


50 

LD 

E.L 


1E20 

LD 

E,n 


66 

LD 

H.IHL) 


DD6605 

LD 

H,(IX+dl 


FD6605 

LD 

H.(IV+d) 


67 

LD 

H,A 


60 

LD 

H,B 


61 

LD 

H,C 


62 

LD 

H,D 


63 

LD 

H.E 


64 

LD 

H.H 


65 

LD 

H,L 


2620 

LD 

H,n 


2A8405 

LD 

HL,(nn) 


218405 

LD 

HL,nn 


ED47 

LD 

I.A 


DD2A8405 

LD 

JX.Inn} 


DD218405 

LD 

IX,nn 


FD2A8405 

LD 

lY.Innl 


FD218405 

LD 

1 Y,r»n 


6E 

LD 

L.IHL) 


DD6E05 

LD 

L,nx+d) 


FD6E05 

LD 

L,(IY+d) 


6F 

LD 

L,A 


68 

LD 

L,B 


69 

LD 

L.C 


6A 

LD 

L.D 


68 

LD 

L.E 


6C 

LD 

L.H 


6D 

LD 

L,L 


2E20 

ED4F 

LD 

L,n 

LD R.A 


ED7B8405 

LD 

SP,(nn) 


F9 

LD 

SP.HL 


DDF9 

LD 

SP.IX 


FDF9 

LD 

SP,IY 


318405 

LD 

SP,nn 


EDA8 

LDD 


Load Location (DEI 
with Location (HL), 

Decrement OE.HL 
and BC 

EDB8 

LDDR 


Load Location (DEI 
with Location (HL), 

Repeat until 8C = 0 

EDAO 

LD1 


Load Location (DE) 
with Location (HL), 

Increment DE.HL, 

Decrement BC 

EDBO 

LOIR 


Load Location (DE) 
with Location (HL), 

Increment DE,HL, 

Decrement BC and 

Repeat until BC = 0 

ED44 

NEG 


Negate Acc, (2's 

Complement) 

00 

NOP 


No Operation 

B6 

OR 

(HL) 

Logical "OR" of 

DD8605 

OR 

liX+dl 

Operand and Acc. 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

FDB605 

OR 

IIY+dl 

Logical "OR" of 

B7 

OR 

A 

Operand and Acc. 

BO 

OR 

B 


B1 

OR 

c 


82 

OR 

D 


B3 

OR 

E 


B4 

OR 

H 


B5 

OR 

L 


F620 

OR 

n 


E08B 

OTDR 


Load Output Port 1C) 
with Location (HL) 

Decrement HL and B, 

Repeat until B = 0 

EOB3 

OTIR 


Load Output Port (C) 
with Location (HL). 

Increment HL, Decre¬ 
ment B, Repeat until 

8=0 

ED79 

OUT 

(CI.A 

Load Output Port (C) 

ED41 

OUT 

(C),B 

with Reg. 

ED49 

OUT 

!C>,C 


ED51 

OUT 

<C),D 


ED59 

OUT 

<C),E 


ED61 

OUT 

(CI.H 


ED69 

OUT 

<C),L 


D320 

OUT 

Inl.A 

Load Output Port (n) 
with Acc. 

EDAB 

OUTD 


Load Output Port (C) 
with Location (HL), 

Decrement HL and B 

EDA3 

OUT! 


Load Output Port (C) 
with Location (HL), 

Increment HL and 

Decrement B 

FI 

POP 

AF 

Load Destination 

Cl 

POP 

BC 

with Top of Stack 

D1 

POP 

DE 


El 

POP 

HL 


DDE1 

POP 

IX 


FDE1 

POP 

1Y 


F5 

PUSH 

AF 

Load Source to Stack 

C5 

PUSH 

BC 


D5 

PUSH 

DE 


E5 

PUSH 

HL 


DDE5 

PUSH 

IX 


FDE5 

PUSH 

IY 


CB86 

RES 

O.(HL) 

Reset Bit b of 

DDCB0586 

RES 

0,(1 X+d) 

Operand 

FDCB0586 

RES 

O.OY+d) 


CB87 

RES 

0,A 


CB80 

RES 

0,B 


CB81 

RES 

o.c 


CB82 

RES 

0,D 


CB83 

RES 

0,E 


CB84 

RES 

0,H 


CB85 

RES 

0,L 


CB8E 

RES 

1 r (HL> 


DDCB058E 

RES 

1.(IX+dl 


FDCB058E 

RES 

T,(1 Y+d) 


CB8F 

RES 

1 ,A 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CB88 

RES 

1.B 

Reset Bit b of 

CB89 

RES 

l.c 

Operand 

CB8A 

RES 

1.D 


CB8B 

RES 

1.E 


CB8C 

RES 

1.H 


CB80 

RES 

1 ,L 


CB96 

RES 

2.IHLI 


ODCB0596 

RES 

2,UX+df 


FDCB059S 

RES 

2.(1 Y+d) 


CB97 

RES 

2, A 


CB90 

RES 

2.B 


CB91 

RES 

2,C 


CB92 

RES 

2.D 


CB93 

RES 

2,E 


CB94 

RES 

2,H 


CB95 

RES 

2,L 


CB9E 

RES 

3,<HL) 


DDC8059E 

RES 

3,(IX+d} 


FDC8059E 

RES 

3,(1 Y+d) 


C89F 

RES 

3.A 


CB98 

RES 

3,B 


CB99 

RES 

3,C 


CB9A 

RES 

3.D 


CB9B 

RES 

3,E 


CB9C 

RES 

3,H 


CB9D 

RES 

3.L 


CBA6 

RES 

4,(H L) 


DDCB05A6 

RES 

4,( IX+d) 


FDCB05A6 

RES 

4,0Y+d) 


CBA7 

RES 

4, A 


CBAO 

RES 

4.B 


CBA1 

RES 

4,C 


CBA2 

RES 

4,0 


DBA3 

RES 

4,£ 


C8A4 

RES 

4,H 


CBA5 

RES 

4,L 


CBAE 

RES 

5,(HL> 


0DCB05AE 

RES 

5.1 IX+d) 


FDCB05AE 

RES 

5,(IY+d) 


CBAF 

RES 

5,A 


CBA8 

RES 

5,B 


CBA9 

RES 

5,C 


CBAA 

RES 

5,D 


CBAB 

RES 

5.E 


CBAC 

RES 

5,H 


CBAD 

RES 

5. L 


CBB6 

RES 

6,(HL) 


DDCB05B6 

RES 

6,(IX+d) 


FDCB0586 

RES 

6.(IY+d) 


CB87 

RES 

6,A 


CBBO 

RES 

6.B 


CBB1 

RES 

6,C 


CBB2 

RES 

6,0 


CBB3 

RES 

6.E 


CBB4 

RES 

6,H 


CBB5 

RES 

6,L 


CBBE 

RES 

7,(HL) 


DDCB05BE 

RES 

7.(IX+d) 


FDCB058E 

RES 

7,(1 Y+d) 


CBBF 

RES 

7. A 


CBB8 

RES 

7.8 


CBB9 

RES 

7,C 


CBBA 

RES 

7,D 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CBBB 

RES 

7,E 

Reset Bit b of 

C8BC 

RES 

7,H 

Operand 

CBBD 

RES 

7.L 


C9 

RET 


Return from 

Subroutine j 

D8 

RET 

C 

Return from 

F8 

RET 

M 

Subroutine if Condi- 

DO 

RET 

NC 

tion True 

CO 

RET 

NZ 


FO 

RET 

P 


E8 

RET 

PE 


EO 

RET 

PO 


C8 

RET 

Z 


ED4D 

RETI 


Return from Interrupt 

ED45 

retn 


Return from Non- 
Maskable Interrupt 

CB16 

RL 

1HL) 

Rotate Left Through 

DDCB0516 

RU 

llX+d) 

Carry 

FDCB0516 

RL 

IIY+d) 


CB1 7 

RL 

A 


CBIO 

RL 

B 


C811 

RL 

C 


CB12 

RL 

D 


CB13 

RL 

E 


CB14 

RL . 

H 


CB15 

RL 

L 


17 

R LA 


Rotate Left Acc. 

Through Carry 

CB06 

RLC 

(HLl 

Rotate Left Circular 

DDCB0506 

RLC 

(IX+d) 


FDCB0506 

RLC 

(lY+dl 


CB07 

RLC 

A 


CBOO 

RLC 

B 


CBOI 

RLC 

C 


CB02 

RLC 

D 


CB03 

RLC 

E 


CB04 

RLC 

H 


CB05 

RLC 

L 


07 

RLC A 


Rotate Left Circular 

Acc. 

ED6F 

RLD 


Rotate Digit Left and 

Right between Acc. and 
and Location (HL) 

CB1E 

RR 

(HU 

Rotate Right Through 

DOCB051E 

RR 

(IX+d) 

Carry 

FDC8051 E 

RR 

IlY+d) 


CB1F 

RR 

A 


CB18 

RR 

8 


CB19 

RR 

c 


CB1 A 

RR 

D 


CB18 

RR 

E 


CB1C 

RR 

H 


CB1D 

RR 

L 


IF 

RRA 


Rotate Right Acc. 

Through Carry 

CBOE 

RRC 

(HL) 

Rotate Right Circular 

DDCB050E 

RRC 

(IX+d) 


FDCB050E 

RRC 

(lY+d) 


CBOF 

RRC 

A 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CB08 

RRC 

B 

Rotate Right Circular 

CB09 

RRC 

c 


C80A 

RRC 

D 


CBOB 

RRC 

E 


CBOC 

RRC 

H 


CBOD 

RRC 

L 


OF 

RRCA 


Rotate Right Circular 

Acc. 

ED67 

RRD 


Rotate Digit Right and Left 

Between Acc. and Location (HL) 

C7 

RST 

OOH 

Restart to Location j 

CF 

RST 

08H 


D7 

RST 

10H 


DF 

RST 

18H 


E7 

RST 

20H 


EF 

RST 

28H 


F7 

RST 

30H 


FF 

RST 

38H 


9E 

SBC 

A,(HL) 

Subtract Operand 

DO9605 

SBC 

A,(IX+d) 

from Acc. with Carry 

FD9E05 

SBC 

A.tIV+d) 


9F 

SBC 

A,A 


98 

SBC 

A,B 


99 

SBC 

A,C 


9A 

SBC 

A,D 


9B 

SBC 

A,E 


9C 

SBC 

A,H 


9D 

SBC 

A,L 


DE20 

SBC 

A,n 


ED42 

SBC 

HL.BC 


ED52 

SBC 

HL.DE 


ED62 

SBC 

hl.hl 


ED72 

SBC 

HL.SP 


37 

SCF 


Set Carry Flag (C = 1) 

CBC6 

SET 

O.iHU 

Set Bit b of Location 

DDCB05C6 

SET 

0,IIX+d) 


FDCB05C6 

SET 

0,IIY+d) 


C8C7 

SET 

0,A 


C8C0 

SET 

O.B 


CBC1 

SET 

0,C 


CBC2 

SET 

O.D 


CBC3 

SET 

O.E 


CBC4 

SET 

0,H 


CBC5 

SET 

O.L 


CBCE 

SET 

1,(HL) 


DDCB05CE 

SET 

1,(IX+d) 


FDC805CE 

SET 

1,(1 Y+d) 


C8CF 

SET 

1 ,A 


CBC8 

SET 

1 ,B 


CBC9 

SET 

1.C 


CBCA 

SET 

1.0 


CBCB 

SET 

1.E 


CBCC 

SET 

1.H 


CBCO 

SET 

1 ,L 


CBD6 

SET 

2,(HD 


DDCB05D6 

SET 

2,(IX*d) 


EDCB0SD6 

SET 

2,(1 Y+dJ 


CBD7 

SET 

2, A 


CBDO 

SET 

2.8 


CBD1 

SET 

2.C 


CBD2 

SET 

2,0 
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OBJ 

CODE 

SOURCE 

STATEMENT 

OPERATION 

CBD3 

SET 

2,E 

Set Bn b ol Location 

CBD4 

SET 

2,H 


CBD5 

SET 

2.L 


CBD8 

SET 

3,B 


CBDE 

SET 

3,(HU 


DDCB05DE 

SET 

3,11 X+d) 


FDCB05DE 

SET 

3,(1 Y+dJ 


CBDF 

SET 

3,A 


CBD9 

SET 

3,C 


CBDA 

SET 

3,D 


CBOB 

SET 

3.E 


C8DC 

SET 

3,H 


CBDD 

SET 

3.L 


CBE6 

SET 

4,(HU 


I DDCB05E6 

SET 

4,f(X+d) 


FDCB05E6 

SET 

4,<IY+d) 


CBE7 

SET 

4,A 


CBEO 

SET 

4,B 


CBE1 

SET 

4,C 


CBE2 

SET 

4,0 


CBE3 

SET 

4,E 


CBE4 

SET 

4,H 


CBE5 

SET 

4,L 


C8EE 

SET 

5.IHLI 


DDCB05EE 

SET 

5,(IX+d) 


FDCB05EE 

SET 

5,(1 Y+d) 


CBEF 

SET 

5.A 


CBE8 

SET 

5.B 


CBE9 

SET 

5.C 


CBEA 

SET 

5,0 


CBEB 

SET 

5,E 


CBEC 

SET 

5,H 


C8ED 

SET 

5,L 


CBF6 

SET 

6,(HL) 


DDCB05F6 

SET 

6,(1 X+d) 


FDCB05F6 

SET 

6,(1 Y+d) 


CBF7 

SET 

6, A 


CBFO 

SET 

6,B 


CBF1 

SET 

6,C 


CBF2 

SET 

6,D 


CBF3 

SET 

6,E 


CBF4 

SET 

6,H 


CBF5 

SET 

6,L 


CBFE 

SET 

7,(H LI 


DDCB05FE 

SET 

7,(IX+d) 


FDCB05FE 

SET 

7,(IY+dl 


CBFF 

SET 

7,A 


! CBF8 

SET 

7,B 


CBF9 

SET 

7,C 


CBFA 

SET 

7,0 


CBFB 

SET 

7,E 


C8FC 

SET 

7,H 


CBFD 

SET 

7.L 


CB26 

SLA 

(HL) 

Shift Operand Left 

DDCB0526 

SLA 

(IX+d) 

Arithmetic 

FDCB0526 

SLA 

(1 Y+d) 


CB27 

SLA 

A 


C820 

SLA 

B 


CB21 

SLA 

C 


CB22 

SLA 

D 


CB23 

SLA 

E 


CB24 

SLA 

H 


CB25 

SLA 

L 
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OBJ 

SOURCE 

OPERATION 

CODE 

STATEMENT 

CB2E 

SRA 

(HL) 

Shift Operand Right 

DDCB052E 

SRA 

HX+d] 

Arithmetic 

FDCB052E 

SRA 

{1V+d) 


CB2F 

SRA 

A 


CB28 

SRA 

6 


CB29 

SRA 

C 


CB2A 

SRA 

D 


CB28 

SRA 

E 


CB2C 

SRA 

H 


CB2D 

SRA 

L 


CB3E 

SRL 

(HL) 

Shift Operand Right 

DDCB053E 

SRL 

(IX+d) 

Logical 

FOCB053E 

SRL 

(lY+dl 


CB3F 

SRL 

A 


CB38 

SRL 

B 


CB39 

SRL 

C 


CB3A 

SRL 

D 


CB3B 

SRL 

E 


CB3C 

SRL 

H 


CB3D 

SRL 

L 


96 

SU8 

(HLI 

Subtract Operand 

OD9605 

SUB 

(IX+d) 

from Acc. 

FD9605 

SU8 

(lY+dl 


97 

SUB 

A 


90 

SUB 

B 


91» 

SUB 

C 


92 

SUB 

D 


93 

SUB 

E 


94 

SUB 

H 


95 

SUB 

L 


D620 

SUB 

n 


AE 

XOR 

(HL) 

Exclusive "OR" 

DDAE05 

XOR 

(IX+d) 

Operand and Acc. 

FDAE05 

XOR 

(lY+d) 


AF 

XOR 

A 


A8 

XOR 

B 


A9 

XOR 

c 


AA 

XOR 

D 


A8 

XOR 

E 


AC 

XOR 

H 


AD 

XOR 

L 


EE20 

XOR 

n 




Example 

Values 

nn 

EQU 

584H 

d 

EQU 

5 

n 

EQU 

20H 

e 


30H 
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DEMONSTRATION PROGRAMS 


9 . 5.1 PROGRAM 1 


5 CUROFF 

10 FORI=1T050:NEXTI:SCREEN1 

20 FORI=1T018STEP2 

30 CIRCLE(0,0),1,1 

40 CIRCLE(239,0),1,1 

50 CIRCLE(0,63),1,1 

60 CIRCLE(239,63),1,1 

70 NEXTI 

Bti CHAR2 

90 L0CATE4,1 

100 FRINT"DVW" 

110 CHARI 

120 LOCATE11,1 

130 PRINT"Microelectronics" 

140 LOCATE12,2 
150 PRINT"presents" 

160 CHAR4 

170 L0CATE9,3 

ISO PRINT"HUSKY SP" 

190 FORI—1T01100:NEXTI 

200 CLS 

210 CHAR3 

220 LOCATE 12,1 

230 PRINT"HIGH RES" 

240 LOCATE 12,3 
250 PRINT"GRAPHICS" 

260 F0RI-1T0999:NEXTI 
270 CLS 

280 F0RI=0T030STEP2 
290 CIRCLE(120,31),I 
300 NEXT I 

310 FORI —1T031STEF‘2 
320 CIRCLE(120,31),1 
325 SQUNDI,100 
330 NEXTI 

340 F0RI=31T01STEP-2 
350 CIRCLE(120,31),I,0 
355 SOUNDI,100 
360 NEXTI 

370 FORI=30TQ0STEP—2 
380 CIRCLE(120,31),I,0 
390 NEXTI 
392 CLS 

395 F0RI=1T0100:NEXTI 

400 LINE(99,63-41)-(126,63-27),1,BF 

402 LINE(96,63-44)-(133,63-24),1,B 

403 LINE(96,63-44)-(92,63-40) 

404 LINE(133,63—44)—(129,63-48) 

405 LINE(96,63—24)-(92,63—28) 

406 LINE(92,63—48)—(129,63-48) 

407 LINE(92,63—48)—(92,63-28) 

408 PSET(130,63-28),(130,63-30),(130,63-32),(130,63-34) . 

409 LINE(131,63—24)—(131,63-10) 

410 LINE(98,63-24)-(98,63-10) 

411 LINE(94,63-26)—(94,63—14) 

412 LINE(127,63-24)-(127,63-14) 

413 LINE(98,63—17)—(131,63—17) 

414 LINE(98,63—17)-(94,63-21) 
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415 LINE(131,63-17)-(127,63-21) 

416 LINE(94,63—21)-(127,63—21) 

417 F0RI=1TD999:NEXT 

41B LINE(100,63—40)—(125,63—28),0,BF 

419 CHARO 

420 F0RJ=1TQ30 

421 LOCATEIB,4 

422 PRINT"DVW" 

423 LINE(101,63-30)-(124,63-30) 

425 NEXTJ 

426 LINE(99,63-41)-(126,63-27),1,BF 
470 FORI=1T0250:NEXTI 

4B0 CLS 

490 FQRI=0T063 

500 LINE(56,I)-(183,I) 

505 S0UND64-I,100 

510 NEXTI 

520 F0RIOT063 

530 LINE(119,63)-(119-1,0),1+1 

540 LINE(120,63)-(120+I,0),1+1 

550 NEXT I 

560 FORI=OTQ63 

570 LINE(119,63)-(56,I),1+1 

5B0 LINE(120,63)-(183,1),1+1 

590 NEXT I 

595 FDRI=1T0500:NEXTI 

600 FORI=OT063 

610 LINE(119,63)—(56,63-I) 

620 LINE<120,63) — (1B3,63—I) 

630 NEXTI 

640 FDRI=OT063 

650 LINE <119,63)-(56+1,0) 

660 LINE(120,63)—(183—1,0) 

670 NEXTI 

680 FOR I=63TQ0STER—1 

690 LINE <56,63—1)-(1B3,63-1),0 

695 S0UND64-I,100 

700 NEXTI 

720 CLS 

730 CHARI 

740 L0CATE3,1 

750 F'RINT"5 Di-fferent character sets 
765 LINE(16,11)—(224,11) 

767 FORI=lT0200sNEXTI 

770 CHAR4 

7eO LOCATES,3 

790 B0SUB1000 

BOO LOCATES,3 

910 G0SUB1030 

B20 CHAR3 

830 LOCATE12,3 

840 G0S1JB1000 

850 L0CATE12,3 

860 GOSUB1030 

870 CHAR2 

BBO LOCATES,3 

890 G08UB1000 

900 LOCATEB,3 

910 GQSUB1030 

920 CHARI 
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930 L0CATE12,3 
940 GDSUB1000 
950 LOCATE 12,3 
960 ETSUB1030 
970 CHARO 
9B0 LOCATE 17,4 
990 GOSUBIOOO 

999 GOTOIO 

1000 F'RINT"A8CD/:<yz" 
1010 F0RI = lTO999s NEXTX 
1015 BEEP 

1020 RETURN 
1030 PRINT" 

1040 RETURN 
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9 . 5.2 PROGRAM 2 


18 CLEAR:CUROFF:SCREEN 1 
20 CIRCLE<[20,31),38 
30 LINEMI9,31-U19.il 
40 LINE(121«3)-(121,6) 

50 LINE(145,31)-(148,31) 

60 LINE<128.56)-(120,59) 

61 LlNE(92.3i)-(95.31) 

70 PSET(134,7),(144,17), (144,45),(134,551,(106,55),(96,45),(96,17),i106,71 

71 T4=TIHE$:HI=VflUNID$(T4,4,2) liHR=VALiLEFTf {Tl ,2)) :SC=VAL{RIGHH(T4,21) 

72 AM=MI*6+270:IFAH>359THENAM=AH-360 

73 AH=HR*30+278:IFA«>359THENAH=AH-360 

74 XM=FIX (23*CDSIAM*PI/180>):YH=FIX(23*SIN<AM*F‘1 /180) i 

75 XH=FIX <I5*C0S(AH*PI/180)):YH=FIX(15*SIN tAH*PI/188 ji 
60 AG=5C*6+270:IFAG>359THENA6=AB-360: 11=500 

90 IFAG>359THENAG=AG-360 
100 TH=AG*P1/180 

110 LINE(12B,3I>-(120+KS,31+YS).0 

120 VS=FIK(25*SINITH)1:XS=FIX(25*C0S'THE:LINEi120,3!i-il20+IS,31+YS) 

121 LINE(120,31)-(120+XM,31+YH) 

122 LINE(120,31)-(120+XH,31+YH) 

123 CHARI,IsLOCATEl.lsPRlNT* ";TIHE4;* " 

150 SGUND100,10 

155 1FAG=270TKENSOSUB200 
160 TU=VAL(RIGHT4(TINE4,111 
170 IFTi=TUTHEN168 
180 TI=TU:AG=AG+6:B0T098 
200 AM=AH+6 

205 IFAM>359THENAM=AM-360 
210 TH=AH*P1/180 

220 LINE(120,31 )-(120+)(M,31+YM),0 

230 KH=FI);S23*C0S(Ttf) 1 :YM=FIX(23*SIN(TH<):LINE(120,31 i-< 128+XM,31+YH) 

240 1FAHO270THENRETURN 
250 AH=AK+30 

255 IFAH/359THENAH=AH-360 
260 TH=AH»PI/188 

270 LINE(12B,31)-(120+XH,31+YH) ,8 

280 XH=FIXC15*C0S(TH)>:YH=FIX(15*SIN(TH)>:LINE(120,31)-(120+XH,31+YH) 

290 RETURN 
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9 . 5.3 PROGRAM 3 


5 CUROFF 
10 SCREEN1 

20 CHAR4:L0CATE4,1:PR INT"HUSKY" 

30 CHAR2,1:LOCATES,3:PRINT"HUNTER" 

35 LINE(15,26) — <14,38) ,1,B 

40 CHAR 1,0:LOCATE 1,4:PRINT" BIB CAPABILITY" 

50 PRINT" small PACKAGE." 

60 LINE <0,0)-(125,6.3) , 1 ,B 

70 CHARO,0:L0CATE23,1:PRINT"The worlds most " 
80 L0CATE23.2:PRINT"advanced hand held" 

90 L0CATE23,3:PRINT"portable micro 

91 L0CATE23,4:PRI NT"HUSKY HUNTER is " 

92 L0CATE23,5:PRINT"CP/t1 compatible ," 

93 L0CATE23,6:PRINT"has upto 208K of" 

94 L0CATE23,7:PRINT"ram and powerful" 

95 L.0CATE23,8: PRINT"communi cati orts. " 

100 INCHR"",A:SCREENO 

110 KEYOFF:CLS 

120 PRINT" A B C D 

130 OPCHR15,4,O 

140 PRINTCHR$(124);:OPCHR15,39,0:PRINTCHR*(124); 

150 0PCHR15,12,0,124,124 

160 0PCHR15,21,0,124,124 

170 OPCHR15,30,0,124,124 

180 F0RI=1TQ7 

190 OF'CHRIS, 2 , I 

200 PRINTSTRt-(I ) ;CHR$<124) ; 

210 NEXT 


220 OPCHR15,4,1:PRINT"< 

734.1> 

45. 82 

-98.42 

798. 11' 

230 0F'CHR15,4,2:PRINT" 

543.72 


543B.63 


240-OPCHR15,4,3:PRINT" 


480.76 

85. 64 

764.11‘ 

250 OPCHR15,4,4:PRINT" 

314.09 

-94.85 


45.23' 

260 OF'CHR 15,4,5: F’R I NT " 
270 0PCHR15,4,6:PRINT" 

134.87 

9845.49 

824.64 

407.45’ 

280 OPCHR15,4,7:PRINT" 


3487.45 

49.76": 



290 OPCHR15,0,0:PRI NT""; 

295 INCHR"",A:CLS 
300 CIRCLE(44,31),31 
310 LINE(44,31)-(66,9) 

320 LINE(44,31)—(44,62) 

330 LINE(44,31)—(15,41) 

340 CHARO 

350 L0CATE6,3: F'R I NT" 417." 

360 L0CATE2,1:PRI NT"UK" 

370 LOCATES, 6: PR I NT "207." 

380 L0CATE2,8: F’RINT"USA" 

390 LOCATE10,5:PRINT"397" 

400 LOCATE13,7;PR INT"Eur ope" 

410 CHAR4:LOCATE 14,1:PR INT"ACME Ltd" 

420 CHARI,1:LOCATE 12,3:PR INT"Profit Distribution 
430 LINE(87,26>-(87,38) 

440 CHAR 1,0: LOCATE 16,4: F'R INT"Fi seal Year" 

450 LOCATE18,5:PRINT"1983-84" 

460 INCHR"",A:SCREENO 
500 SCREEN1 

510 LINE(0,0)-(239,63),1,B 
520 F0RI=0T0239STEP8 
530 F'SET (1,59) 
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540 PSET(I+1,60),(1+2,60),(1+6,60),(1+7,60) 

550 PSET(I+3,61> , <I+4,61) , (1+5,61> 

560 NEXT 

570 LINE<50,60)-(45,50) 

580 LINE(45,50)—(45,46) 

590 LINE(45,46)-(39,40) 

600 LINE(39,4i> — (34,46) 

610 L.INE- (37,49) 

620 LINE-(42,44) 

630 LINE(45,46)—(62,46) 

640 PSET(63,47),(63,48),(64,49) 

650 LINE(45,50)- £ 150,50> 

660 PSET(151,49),(152,48),(152,47),(153,46) 

670 LINE(153,46)-(173,46) 

680 LINE(173,46)-(155,60) 

690 LINE(173,46>-(194,40) 

700 LINE(145,50)—(145,10) 

710 LINE(145,10)—(193,40) 

720 L' I NE (71,50) — (71,15) 

730 LINE(71,15)-(45,46) 

740 LINE(108,50)-(108,1) 

750 LINE(100,1)-(71,15) 

760 LINE (10B, 1-) - (145,10) 

770 LINE(61,24> — (78,20) 

7BO LINE <58,39) - (94- ,34) 

790 LINE(98,il)-(115,7) 

BOO LINE(95,25)-(121,20) 

810 LINE(92,42)-(127,36) 

820 LINE(135,19)-(152,15) 

830 LINE(132,34)—(158,29) 

840 E0RI-64TQ150STEP10 
850 PSET(I,53) 

860 NEXT 

870 LINE <160,48)-(156,52) 

880 PSET(155,51),(155,50),(156,49),(157,53),(158,53),(159,52) 
890 PSET(158,48),(160,50> 

991 PSET(37,18),(37,17),(36,16),(35,16),(34,16),(33,17) 

892 PSET(38,16),(39,16),(40,16),(41,17) 

893 CIRCLE(0,0),15 

894 PSET(210,51),(210,50),(209,49),(208,49!,(207,49),(206,50) 

895 PSET(211,49),(212,49),(213,49),(214,50) 

900 CHARO,1:L0CATE30,2: PRINT"HMS BOUNTY" 

910 LINE(173,7)-(233,15),1,B 

999 INCHR" " , P,: SCREENO: GOTO 1 
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9.5.4 PROGRAM 4 'UNLOAD' 

On the host computer type the following program into a text file 
with the name UNLOAD.HEX. Before the file can be used it has to 
be converted to a .COM file, to convert the file enter the 
following command: 

>LOAD UNLOAD.HEX 

This will create a file with the name UNLOAD.COM and can now be 
used to convert any file into INTEL HEX format. To convert a 
file enter the folowing: 

XJNLOAD sourcefile filename.HEX 

The first file 'sourcefile' is the name of any file required to 
be converted, the second file 'filename.HEX' will then contain 
the INTEL HEX version of the file. 

The HEX format file will always be located at 100H, but if all 
transferred data is saved into new files, (with the SAVE n 
command) then this is not a problem. 

A source code version of UNLOAD is available on request from 
Husky Computers or authorised agents, either as a listing or 8" 
IBM compatible disk. 


VER.V09F 


PAGE 9-33 



APPENDIX 


SECTION 9.5 


UNLOAD PROGRAM 


20010000C334020000000000000000000000000000000000000000000000000000000000E6 
20012000OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOBF 
20014000000000000000000000000000000000000000000000000000000000Q0000000009F 
2001600000000000000000000000000000000000000000000000000000000000000000007F 
2001800000000000000000000000000000000000000000000000000000000000000000005F 
2001A00000000000000000000000000000000000000000000000000000000000000000003F 
2001COOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO1F 
2001E0000000000000000000000000000000000044495343206572726F7224536F75726362 
20020000652F6F626A6563742066696C65206572726F7224436F6E76657274696E67202E38 
200220002E2E202424436F6D706C65746564202E2E2E20242A0600110100AFED52E5F1CD9C 
200240005E04011000216C0011C601EDBO3A6DOOFE2GCC3D04115C0OOEOFCDO5CO3CCC3DB6 
200260000411C601OE13GD050011C601OE16CD05003CCC4F041114020E09CD05001124023F 
200280000E09CD05001180000E1ACD0500115C000E14CD0500B7C41303AF32C5013AC5015 1 
2002A000FE8O28E15F3C32C5011600218000197ECD9D0321OCO106003AC3014F09722373B7 
2OO2C0OO0COC79FE34280632C3O1C39D02AF32C301CDC403CDE90321C4017EFE0128103612 
2002E00001210301114301014000EDB0839D023600210301118301014000EDB01143010E12 
200300001ACD050011C601OE15CD0500B7C44FG4C39D0221OCO106003AC3014F09FE342810 
20032000063630233C1800CDC403CDE9033AC401F5FE012805114301180311830121030143 
20034000014000EDBOF1FE 01280C3E0132C40121OCO13E0018C7 1 14301OE1ACD0500 1 1C6F 4 
20036000010E15CD0500B7C44F04067F3E00214401772310FC060C2144013E30772310FC5E 
200380002150013E1A7711C601OE15CD0500B7C44F0411C601OE10CD0500C34604F 5E60FC2 
2003AOOOFEOAFAA903C6371802F6305FF1CB1FCB1FCB1FQB1FE60FFE0AFAC003C637 57C983 
20O3CO0OF63057C92AEE01111A001922EE01E57CCD9D037A3206017B320701E17DCD9D036ES 
2003E0007A3208017B320901C9210401061E110000AF7E4F237E23FE40FAFE03D607E60F22 
20040000835F17171717F57BE60F5F79FE40FA1304D607E60F8257F13E008A5710D37BE613 
200420000F5F7 A17171717E6FOB3ED44CD9D037A3240017B3241013E0D324201C911FBO1DF 
20044000CD5804C30000112502CD5804C3000011F001CD5804C300000E09CB0500C906EAFC 
20046000AF21030177231OFC1124020E09CD05C0210301363A23363123364121E60022EE12 
090480000121OAO13E30772377C7 
00000001FF 
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MEMORY LOCATIONS 


Location 

(Decimal) 

Location 
(Hex) 

Name 

Function 

55043 ' 

55046 

55049 

55052 

55055 

55058 

55061 

D703 

D706 

D709 

D70C 

D70F 

D712 

D715 

JMP WARMSTART 
JMP CONSTAT 

JMP C0NIN 

JMP CONOUT 

JMP LIST 

JMP PUNCH 

JMP READER 

CP/M BIOS jump table 

55296-55424 

D800-DF8Q verscrn 

•Virtual screen 80 x 24 characters D800 
is the top left hand corner. 

57344-61439 

E000-EFFF 

Operating system area. 

61440-62463 

F000-F3FF 

I/O Buffers. 

62981-63061 

F605-F655 USER 

This Ram area is left free by the 
operating system and is vailable for 
use as user machine code routines. 

63168-63359 

F6C0-F77F 

O/S Stacks. 

63360 

F780 

IPFLAG 

Logical keyboard flag: 

0 = HUNTER keyboard/LCD screen 

128(80H) = Serial I/O port 

63364 

F784 

VECTOR 

HELP vector address. The key is 
trapped by the keyboard softwear and is 
vectored to this location. 

63415 

F7B7 

APHRO 

Flag to indicate how HUNTER was powered 
up: 

0 = Keyboard 

1 = Serial port 

2 = Clock 

63416 

F7B8 

NYMPHO 

If the standard power down routine is 
used then setting this byte non-zero 
will inhibit operation of the power off 
key. 

NOTE: This byte is cleared on power up. 

63419 

F7BB 

FOREVER 

Setting non-zero prevents automatic 


switch off after time-out. 
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Location 

(Decimal) 

Location 

(Hex) 

Name 

Function 


63464 

F7E8 

TENTHSEC 

Time 

memory 

1/10 sec. 

63465 

F7E9 

UNITSEC 

If 

it 

unit sec. 

63466 

F7EA 

TENSEC 

II 

ti 

tens sec. 

63467 

F7EB 

UNITMIN 

n 

ii 

unit mins. 

63468 

F7EC 

TENMIN 

it 

ti 

tens mins. 

63469 

F7ED 

UNITHRS 

u 

it 

unit hours. 

63470 

F7EE 

TENHRS 

ii 

ii 

tens hours. 

63471 

F7EF 

DNITDAY 

ti 

it 

unit days. 

63472 

F7F0 

TENDAY 

ii 

it 

tens days. 

63473 

F7F1 

UNITMTH 

ii 

ii 

unit month. 

63474 

F7F2 

TENMTH 

it 

ir 

tens month. 

63475 

F7F3 

UNITYR 

ii 

it 

unit years. 

63476 

F7F4 

TENYR 

ii 

it 

tens years. 

63480 

F7F8 

TXSPEED 

Set 

serial 

0/P baud rate 


1 = 75 4 = 300 7 = 1800 

2 = 110 5 = 600 8 = 2400 

3 = 150 6 = 1200 9 = 4800 

/° r 


63481 

F7F9 

RXSPEED 

Set serial I/P baud rate (same 
(TXSPEED). 

63482 

F7FA 

CTSAF 

The CTS enable flag: 

0 = No 1 = Yes 

63483 

F7FB 

DTRAF 

The DTR enable flag: 

0 = No 1 = Yes 

63484 

F7FC 

RTSAF 

The RTS enable flag: 

0 = No 1 = Hold 2 = True 

63485 

F7FD 

DSRAF 

The DSR enable flag: 

0 = No 1 = Yes 

63486 

F7FE 

DCDAF 

The DCD enable flag: 

0 = No 1 = Yes 

63487 

F7FF 

TXPTY 

Transmit parity flag: 

0 = None 1 = Odd 2 = Even 

63488 

F800 

RXPTY 

Receive parity flag: 

0 = None 1 = Odd 2 = Even 
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Location 

(Decimal) 

Location 

(Hex) 

Name 

Function 

63489 

F801 

TXPROT 

Transmission protocol: 

0 = None 

1 = XON/XOFF 

2 = ETX/ACK 

3 = ACK/NAK 

4 = SYSTIME 

C'l&n 

63^90 

F802 

LFACT 

Line feed active or not: 

0 = No 1 = Yes 

63491 

F803 

NULAF 

Number of NULLs following CR/LF: 

0 = None 

1 = Two 

2 = Five 

3 = Ten 

4 = Twenty 

63492 

F804 

ECHOF 

The serial output echo flag: 

0 = No echo (Full Duplex) 

1 = Output echoed to HUNTER’S screen 

63493 

F805 

RXPROT 

Receive protocol (as TXPROT). 

63494/63496 

F807/F808 CTSVECT 

CTS interrupt vector. These locations 
contain an address for the CTS input. 

63502 

F80E 

ESCODE 

Escape code. Used when escaping from 
fully running code. Used to interrupt 
execution of user programs when Basic 
auto-start is in use. ASCII characters 
are stored in Decimal form, most 
significant digit at lowest memory 
location. 

63507 

F813 

STARTFL 

Flag to indicate immediate running of 
user Basic program. 

AAH = Immediate run. 

63551/63552 

F83F/ 

F840 

ALIM 

Address of the lower limit of Basic 
Symbol table End of free Memory. 

63553/63554 

F841 / 
F842 

DEFLIM 

Beginning of free memory after Basic 
source and arrays. 
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Location 

(Decimal) 

Location 

(Hex) 

Name 

Function 

63563 

F84B 

SERIG 

This contains the ASCII code of a 
character to ignore when receiving 
serial data. If not required set to 
80H (128 decimal). 

63571 

F853 

RECLEN 

This is a single byte defining maximum 
record length. (See section 6.7) 

63572 

F854 

BUFLEN 

This is a two byte number defining 
maximum block length. (See section 6.7) 

63574 

F856 

SRFLG 

This flag controls single or multiple 
records in a block. (See section 6.7) 

63575 

F857 

RPFLG 

A single byte flag used to control 
record padding. (See section 6.7) 

63576 

F858 

EMFLG 

Determines essential differences 
between 2780 and 3780 communications. 
(See section 6 . 7 ) 

63577 

F859 

STXLFG 

A single byte flag controlling use of 
intermediate STXs. (See section 6.7) 

63578 

F85A 

RETRYS 

A single byte flag controlling error 
handling by the protocol. (See section 
6.7) 

63579 

F85B 

SCFLG 

A single byte flag controlling 
operation of space compression. (See 
section 6.7) 

63584 

F860 

BARTYP 

Select Bar code type 

OPCODE 39 

1=EAN8/13 

63585 

F861 

TOPAGE 

Maximum number of pages in HUNTER. 

Note: Bit 7 is set to indicate "RAM". 

63889 

F991 

LSTBSN 

CAPS lock 0=OFF l=ON 

Note: must be 0 or 1 

65266 

FEF2 

KEYBUF 

112 bytes of keyboard RAM, see section 
9.6, KEYBOARD MEMORY MAP. 
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Location 

Location 

Name 

Function 

(Decimal) 

(Hex) 



65378 

FF62 

SPELFLG 

Keyboard changed flag 

1=changed keyboard layout 

63420 

F7BC 

COMERR 

Location which maintains the error code 


for a communications error. This 
location is normally clean. 


63581 

F85D 

RXTOAF 

Receive timeout active (parameters as 
TXTOAF). 

63582 

F85E 

TXTOAF 

Transmit timeout active 


0 = no 

timeout 





1 = 10 

sec 

timeout 

4 

= 40 

sec 

timeout 

2 = 20 

sec 

timeout 

5 

= 50 

sec 

timeout 

3 = 30 

sec 

timeout 

6 

= 60 

sec 

timeout 
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PORT ALLOCATIONS 


9.8 HUNTER uses the NSC800 port map for all Its I/O functions, 

including the keyboard, RS-232, etc. The following gives a list 
of the most useful ports which can be controlled from Basic 
using OUT or INP verbs or from machine code. 


Address Name Description 

Decimal Hex 


1 1H DSR Bit seven is the DSR input 

bit. 

1 = Inactive 

2 = Active 

2 2H INPUTS This port has a number of 

input functions: 

Bit 0 = Data in (inverted 
from RS-232 line) 

Bit 1 = DCD - " - 
Bit 2 = Power low warning 
1 = Power O.K 
0 = Power low 

Bit 3 = TXCLK - " - also the 
single input bit. 


96 

60H 

ANGLE 

Controls display viewing 
angle. Input value in the 
range 0-1FH 

129 

81H 

V240UT 

Directly outputs to the V24 
data line signal on bit 0. 
The output is voltage 
inverted i.e. 

0 = +Ve 1 = -VE 

130 

82H 

RTS 

RTS output bit 

131 

83H 

POWHLD 

Power control 

bit 0 = 1 : HUNTER on 

bit 0 = 0 : HUNTER off 

132 

8MH 

INVCON 

V24 inverter control 
bit 0=1: inverter on 
bit 0=0: inverter off 

133 

85H 

DTR 

DTR output bit 
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135 87H AUXPWR Turns on the auxilary 

power to pin 10 on the 'D' 
type connector 
1 = Power on 
0 = Power off 

187 BBH ICRREG NSC800 internal interrupt 

mask register. See NSC800 
hand book. 

224 EOH PAGE Memory paging register 
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SINGLE BIT INPUT PORT 


9.9 The single input bit has been implemented for use with devices 

such as bar-code wands, voltage free switch contacts, etc. It 
is provided via the 4 pin LEMO socket pin 2. Note should be 
made that it is shared with the TXCLK on the V24 interface (pin 
15). It should not, therefore, be used at the same time as the 
communications when hardware handshaking is in use. 

9.9.1 CIRCUIT IMPLEMENTATION 

The input is configured as a protected, pulled up CMOS 
compatible line: 

Fig 9.1 CIRCUIT LAYOUT 



It has a logic 1 threshold of > 3.5V and a logic 0 < 1.5V, It is 
protected to +25V. 

The pull-up resistor enables the use of a switch to ground to 
provide the input. 

Ho debounce circuitry is provided. If it is required then 
software must be written for this purpose. 

This is bit 3 on I/O port 2. See 9.8 
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Fig 9.2 PIN-OUT OF LEMO CONNECTOR 


PIN NO 

SIGNAL 

1 

GROUND 

2 

TX CLK or input 

3 

Charger/reset 

4 

5V output (Wand option only) 


VER.V09F 


PAGE 9-42 





APPENDIX 


SECTION 9.9 


9.9.3 LEMO CONNECTOR 

The four pin LEMO plug is installed by aligning the red mark on 
the plug sleeve with the corresponding red mark on HUNTER'S LEMO 
socket, the square pin on the plug body must also align with the 
key-way on the socket. The LEMO plug is then pushed firmly into 
HUNTER'S socket until the outer sleeve of the plug is flush with 
the casing of HUNTER'S LEMO socket. 

9.9.3.1 Removal of LEMO Plug 

To remove the LEMO plug from HUNTER it is necessary to pull back 
the spring loaded outer sleeve before pulling the plug out of 
HUNTER'S socket. 
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9.10 

9 . 10.1 


9 . 10.2 


RS232 CONNECTOR 


The 25 way D type connector is used for connecting standard 
serial devices using RS 232 to HUNTER. 



Connector Type 


The connector is of the male type. It should only be used with 
standard female types. 


9.10.3 Connector Locking 

Two locking tabs are provided. These may be used to secure the 
mating connector securely. 

Recommended clips are: 

D53018 ITT Canon 

For a full explanation of the use of these signals, see section 
6 COMMUNICATIONS. 
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HEX DATA FORMAT 


9.11 HUNTER provides the industry standard 'Intel Hex' data format 

compatible with most CP/M computers. .COM files may be 
converted to .HEX files with the UNLOAD utility in the host 
machine, and then 'pipped' out. 

The data is split into blocks with leader and trailer 
information and the data in between. Each data block contains 
the memory locations into which the data is to be placed. 

A single block of data appears as:~ 

: BBAAAAOODD.DDCC 

where BB = No of data bytes 
AAAA = Address of block 
00 = Null record 
DD = Data byte 
CC = Checksum 

Each byte is composed of two ASCII hexadecimal characters (0-9 
and A-F) 

The record starts with a colon which is detected by the 
receiving system. This is followed by a count of the data 
bytes, the starting address, a delimeter, the data itself and a 
checksum on the end. 

The checksum is calculated as the twos complement of the modulo 
256 addition of all the preceding bytes. 

The transmission is ended with a block of zero length. 

:0000000000 

9.11.1 ERROR MESSAGES 

When loading HUNTER the address of the information is checked to 
ensure that it has written to the useable address space of the 
physical memory. Also the checksum is checked. If either of 
these checks fails, then an error message is displayed. 

* * Memory overflow * * 
or 

* * * Loading Error * * * 
as appropriate. 
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Reception at the end of record gives: 

* * Loading completed * * 

The loading may be aborted at any time by pressing ESC. 

The length of input data records is optional and is specified by 
the record up to 255 bytes. 

9.11.2 HEX TRANSMISSION 

The length of the record is fixed at sixteen data bytes. To 
start the transmission HUNTER awaits the ENTER key to ensure 
that all connections have been made. The data may be echoed 
onto the screen to verify active transmission. The transmission 
may be aborted by pressing ESC. 

9.11.3 LOADING MACHINE CODE PROGRAMS 

The Hex data format will load any object code into memory. This 
may then be executed using the CALL statement in Basic, or 
loaded into a file with the file manager. 
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ASCII TO EBCDIC CONVERSION 


When using EBCDIC communications HUNTER provides ASCII to EBCDIC 
conversion as follows: 


(all values are in Hex) 


ASCII 

CHAR 

EBCDIC 

— 

ASCII 

CHAR 

EBCDIC 

00 

NULL 

00 

20 

SPACE 

40 

01 

SOH 

01 

21 

T 

5A 

02 

STX 

02 

22 

II 

7F 

03 

ETX 

03 

23 

HEX 

7B 

04 

EOT 

37 

24 

$ 

5B 

05 

ENQ 

2D 

25 

% 

6C 

06 

ACK 

2E 

26 

& 

50 

07 

BEL 

2F 

27 

1 

7D 

08 

BS 

16 

28 

( 

4D 

09 

HT 

05 

29 

) 

5D 

0A 

LF 

25 

2A 

* 

5C 

0B 

VT 

OB 

2B 

+ 

4F, . 

OC 

FF 

OC 

2C 

} 

6B 

OD 

CR 

OD 

2D 


60 

OE 

SO 

OE 

2E 

« 

4B 

OF 

SI 

OF 

2F 

/ 

61 

10 

DLE 

10 

30 

0 

FO 

11 

DC1 

11 

31 

1 

FI 

12 

DC2 

12 

32 

2 

F2 

13 

DC3 

13 

33 

3 

F3 

14 

DC4 

14 

34 

4 

F4 

15 

NAK 

3D 

35 

5 

F5 

16 

SYN 

32 

36 

6 

F6 

17 

ETB 

26 

37 

7 

F7 

18 

CAN 

18 

38 

8 

F8 

19 

EM 

19 

39 

9 

F9 

1A 

SUB 

3F 

3A 

• 

• 

7A 

IB 

ESC 

27 

3B 

• 

J 

5E 

1C 

FS 

22 

3C 

< 

4C 

ID 

GS 

ID 

3D 


7E 

IE 

RS 

IE 

3E 

> 

6E 

IF 

US 

IF 

3F 

? 

6F 
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ASCII 

CHAR 

EBCDIC 

ASCII 

CHAR 

EBCDIC 

40 

§ 

7C 

60 

\ 

79 

41 

A 

Cl 

61 

a 

81 

42 

B 

C2 

62 

b 

82 

43 

C 

C3 

63 

c 

83 

44 

D 

C4 

64 

d 

84 

45 

E 

C5 

65 

e 

85 

46 

F 

C6 

66 

f 

86 

47 

G 

C7 

67 

g 

87 

48 

H 

C8 

68 

h 

88 

49 

I 

C9 

69 

i 

89 

4A 

J 

D1 

6A 

j 

91 

4B 

K 

D2 

6B 

k 

92 

4C 

L 

D3 

6C 

1 

93 

4D 

M 

D4 

6D 

m 

94 

4E 

N 

D5 

6E 

n 

95 

4F 

0 

D6 

6F 

0 

96 

50 

P 

D7 

70 

P 

97 

51 

Q 

D8 

71 

q 

98 

52 

R 

D9 

72 

r 

99 

53 

S 

E2 

73 

s 

A2 

54 

T 

E3 

74 

t 

A3 

55 

U 

E4 

75 

u 

A4 

56 

V 

E5 

76 

V 

A5 

57 

w 

E6 

77 

w 

A6 

58 

X 

E7 

78 

X 

A7 

59 

Y 

E8 

79 

y 

A8 

5A 

Z 

E9 

7A 

z 

A9 

•5B 

[ 

00 

7B 

{ 

CO 

5C 


EO 

7C 


6A 

5D 

] 

00 

7D 

} 

DO 

5E 

A 

5F 

7E 


A1 

5F 

- 

6D 

7F 

DEL 

07 
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FOUR OCTAVE SOUND RANGE 


Middle 


Note 

Frequency 

Pitch 


(Hz) 

Parameter 

C 

138.810 

493 

D 

146.830 

439 

E 

164.810 

391 

F 

174.610 

368 

G 

196.000 

326 

A 

220.000 

290 

B 

246.940 

260 

C 

261.630 

244 

D 

293.660 

217 

E 

329.630 

193 

F 

349.230 

182 

G 

329.000 

162 

A 

440.000 

144 

B 

493.880 

128 

C 

523.250 

121 

D 

587.330 

107 

E 

659.260 

95 

F 

698.460 

90 

G 

783.990 

80 

A 

880.000 

71 

B 

987.770 

63 

C 

1046.500 

59 

D 

1174.700 

52 

E 

1318.500 

46 

F 

1396.900 

43 

G 

1568.000 

38 

A 

1760.000 

34 

B 

1975.000 

30 

C 

2092.000 

28 
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CONHGURING TYPICAL CP/lV PROGRAMS 


9.14 This appendix describes the installation procedure for a number 

of common commercial CP/M programs. The purpose of the 
installation is to configure the program to the screen handling 
control codes within HUNTER. 

The control codes used by the HUNTER screen are: 

a) Clear Screen 01H 

b) Home Cursor 02H 

c) Cursor Addressing OFH, <x co-ord>,<y co-ord> 

d) Cursor Right OCH 

e) Cursor Left 08H 

f) Cursor up OBH 

g) Cursor down OAH 

The installation procedure is generally carried out on a 
standard CP/M desk-top machine prior to down-loading 
information, see Section 3.6 

9.14.1 MBASIC 

Standard disk-based Microsoft Basic can be down-loaded into 
HUNTER with no installation or modification. 

The only file to transfer is MBASIC.COM. MBASIC may now be run. 

9.14.2 WORDSTAR VERSION 2 

The standard disk from MicroPro has the following files: 

INSTALL.COM 
WSU.COM 
WSMSGS.OVR 
WS0VLY1.OVR 

The INSTALL program is used to configure the main Wordstar 
program WSU.COM or an existing Wordstar file (WS.COM). 

The two overlay files, WSMSGS.OVR and WS0VLY1.0VR, do not need 
any alteration. 

When using the INSTALL program, refer to the Wordstar manual for 
further information - INSTALL is faily self explanatory. The 
main features of the procedure are explained below: 

1) Type INSTALL to load and run INSTALL on your desk-top unit. 

2) Select the appropriate Wordstar file, e.g. WSU.COM. 
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3) Terminal MENU : select "Z" for "none of the above." This 
will be described later when patching in the exact controls. 

4) Printer MENU : select your own type of printer - typically, 
selection "A" will be compatible with most types of printer. 

5) Communications Protocol MENU : select "N", this will enable 
HUNTER'S own communications package to handle any necessary 
protocol. 

6) Driver MENU : select "L" for the standard CP/M list device. 

7) You are now prompted for: 

ARE MODIFICATIONS TO WORDSTAR NOW COMPLETE?: 

Answer "N" for No, as it is now necessary to patch the codes 
for the terminal selection. 

INSTALL will prompt with: 

LOCATION TO BE CHANGED (0=END):0248 
ADDRESS:0248H OLD VALUE:00H NEW VALUE:18 

In the above example, location 0248 was entered and the New 
Value 18H entered. This procedure should be repeated for 
the following locations: 

LOCATION (Hex) New Value (Hex) FUNCTION 


0248 

18 

Screen Height (24 lines) 

0249 

50 

Screen width (80 characters) 

024A 

01 

Clear screen 

024B 

OF 

Cursor positioning 

0253 

00 

II 

0258 

00 

II 

025D 

FF 


025E 

00 

II 

025F 

00 

II 

0260 

00 

II 

0264 

00 

11 

02AA 

00 

Inhibit scrolling 

After engineering 

these 

patches, terminate the procedure by 

entering 0 when the 

next 

location is requested. 
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9.14.3 


After confirming the selections and exting from INSTALL, the 
three files: 

WS.COM 
WSMSGS.OVR 
WS0VLY1,0VR 

are ready to be loaded and run, see Section 3.6 for details of 
the procedure. 

SuperCale Version 1 

The standard disk from Sorcim has the following files: 

INSTALL.COM 

SC.COM 

SC.OVL 

SC.HLP 

The INSTALL program is used to configure the main program 
SC.COM. The two other files SC.OVL and SC.HLP do not need any 
alteration. 

It will be helpful to refer to the SuperCale manual when using 
INSTALL. 

However, below is set out the response to each menu choice to 
install for the HUNTER, after running the "INSTALL.COM" program. 

a) Terminal Selection Menu 

No automatic installation is provided for HUNTER. Type in 
’x* (not specified on the screen) for manually setting up 
the various options. 

A second menu is displayed showing options A-F. Each option 
should be configured as described. 

A. EDIT SCREEN CONTROLS 

Another menu is displayed. Choose each option in turn and 
modify as prompted until the following is displayed: 

1 Clear Screen : 1,01 
.2 Clear to EOL : Unconfigured 
3 Home cursor : Unconfigured 

Return to the main selection and run by pressing x. 
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B. EDIT ATTRIBUTE DATA 

No configuring is necessary. Each option should be: 

1 Set (start) Cursor attribute : Unconfigured 

2 Clear (end) Cursor attribute : Unconfigured 

3 Set (start) Border attribute : Unconfigured 

4 Clear (end) Border attribute : Unconfigured 

C. EDIT INPUT KEYS 

1 Keyboard lead-in character : No lead-in character 

2 Key to input for -up : K (Control K) 

3 Key to input for -down : J 

4 Key to input for -left : H 

5 Key to input for -right : L 

6 Key to input for Help : No help key 

D. EDIT GOTO XY, PRINTER INIT. STRING 

1 Printer init. string 
leave unconfigured 

2 Goto XY routine (for cursor addressing) 

type in the following string of bytes: 

D5, 3E, OF, CD, 7D, 01, D1, D5, 7B, D6, 20, F6, 80, 
CD, 7D, 01, D1, 7A, D6, 20, F6, 80, C3, 7D, 01 

E. EDIT MISCELLANEOUS DATA 


0 Display Border Character -7Ch 

1 No. of video lines (down) -12 

2 No. of video columns (across) -40 

3 No. of printer lines -66 

4 No. of printer columns -132 

5 Dumb terminal cursor brackets 
Left = "<" Right = ">" 

6 CPU frequency (in 1000s Hz) -4000 

7 Baud rate used (for delays) -12 

8 No. of CRT attribute -0 

9 Use printer status (in BIOS) -1 

(1 = yes, 0 = no) 
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F. EDIT TERMINAL NAME 


Enter name = Husky HUNTER 


Then type X to finish editing data, and A to save SuperCalc 
on disk. 

The files: 

SC.COM 

SC.OVL 

SC.HLP 

are now complete. 

9.14.4 Loading dBASE Programs 


The well known data base package, dBASE II, can be installed to 
run on the HUNTER. Described below is the sequence of responses 
to the install program to give full functions to the software 
package. 

The version described is V2.3B, which is supplied as 13 
individual files. They are: 

DBASEMOD.OVR 
DBASEMSC.OVR 
DBASERPG.OVR 
DBASESRT.OVR 
DBASETTL.OVR 
DBASEUPD.OVR 
INSTALL.COM 

The first three files are vital to any dBASE program, but the 
rest are separate overlay files each supporting a particular 
function. 


DBASE.COM 
DBASEMSG.COM 
DBASEMAI.OVR 
DBASEAPP .OVR 
DBASEBRO.OVR 
DBASEJOI.OVR 


For example, if a sort facility is required, then the 
DBASESRT.OVR file will be required on the HUNTER. 


9.14.5 Installing dBASE 

On your host CP/M machine, type: 
INSTALL 

to run the install program. 
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The first question will ask whether you require full screen 
operations. 

Type 'Y' 

A menu of diferent types of VDU will then appear. 

Select T Z' 

for user supplied terminal commands. 

The next question refers to the type of data to be entered. All 
data will be in hex, so answer accordingly. 

1. DELETE A CHARACTER SEQUENCE 

The correct sequence is 03,08,20 

2. DIRECT CURSOR POSITIONAL SEQUENCE 

Column number position = 02 
Line number position = 03 
Constant bias = 00 

The skeleton is OF,00,00 

3. CLEAR AND HOME SCREEN COMMANDS 
01 

4. BRIGHT/STD VIDEO COMMANDS 
None 

5. DIM/REVERSE VIDEO COMMANDS 
None 

6. INITIALISATION SEQUENCE 
None 

7. EXIT SEQUENCE 
01 

8. RESET TO STANDARD VIDEO MODE 
None 
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9.14.6 


9. ALTER SCREEN SIZE 

Screen width = 40 
Number of lines = 08 

Completion of Installation 

To complete installing, default the macro character to and 
key-in a space for no error dialogue. 

The CP/M operating system is version 2.2., therefore: 

Enter "A" 

to complete the installation. The above files are now ready for 
installation. 
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9.15 Read Console Buffer 

CP/M call 10, Read Console Buffer, has a range of additional 
facilities. 

The read buffer reads a line of edited console input into a buffer 
addressed by registers DE. Console input is terminated when either 
the buffer overflows, or on control J or control M. 

The Read buffer is of the form: 


DE | +0 | +1 j +2 | +3 ! +4 | +5 | . I +N ! 

1 mx j nc | cl j c2 ' c3 I c4 | . i ?? | 

where mx is maximum number of characters the buffer will hold (1 to 
255). 

nc is the number of characters read (set by DEMOS on return), nc is 
followed by Cl, C2, etc., the characters read from the console. 

If nc < mx then uninitialised positions follow the last character 
(represented above by ?). 


A number of control functions are recognised during line edit: 


Control C 
Control E 
Control H 
Control J 
Control M 
Control R 
Control X 


reboots system if at start of line 
causes physical end of line 
backspace one character position 
terminate input 
terminate input 

retype current line after new line 
backspaces to beginning of current line 
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